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PREFACE 


The information about the Perkin-Elmer Multi-Terminal Monitor 
(MTM) in this manual is written for the MTM user and can also be 
helpful to the system operator and system programmer. 


Chapter 1 is a general description of the MTM system, containing 
information on MTM system requirements, MIM features, and various 
conventions. Chapter 2 describes MTM user commands. Chapter 3 
describes MTM to non-MTM task interfaces that allow users’ to 
transfer control of their terminal between MTM and other non-MTM 
tasks (HASP, ITC/Reliance, Foreground) and return to MTM in an 
orderly fashion. Chapter 4 describes the program development 
commands. Chapter 5 describes batch processing under MTM. 
Chapter 6 describes the command substitution system (CSS) and the 
CSS commands. Chapter 7 describes spooling and briefly 
elucidates the two spoolers (0OS/32 and SPL/32) available to users 
of OS/32 and MTM. 


Appendix A summarizes the MTM user commands. Appendix B is a 
summary of the program development commands. Appendix C 
summarizes the CSS commands. Appendix D is an MTM- command 
message summary. Appendix E is a summary of CSS messages. 


Appendix F is a summary of program development command messages. 
Appendix G is a summary of MTM to non-MTM task interface 
messages. Appendix H is a control summary for the Bidirectional 
Input/Output Control (BIOC) CRT driver. 


Revision RO1l of this manual adds two new file types to the 
ALLOCATE, TEMPFILE, and XALLOCATE commands. New software density 
selection options are added to the ASSIGN command. MTM now 
supports up to a maximum of 65,535 accounts. A new type of user 
(a PRIVILEGED user) is introduced along with new commands (SET 
GROUP, SET PRIVATE, PRIOR) that enable the privileged user to 
access any account on the system. A new PASSWORD command has 
been added to allow users to alter their own password to’. enhance 
account security. Two new variable types have been added to 
MTM's CSS processor: new global and new internal variables. A 
command to define these new variable types, the $DEFINE command, 
‘has been added. Also, a new command to release these new 
variable types, the $RELEASE command, has been added. MT aiso 
has the capability to use keywords and positional parameters’ in 
CSS calls and reference them within CSS routines. A powerful 
character replacement command (%...%) has been added to enable 
replacement of characters within CSS _ lines on a call-by-call 
basis. New interface protocols between MTM and non-MTM tasks are 
available. 
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Changes were made to the DISPLAY DEVICES, DISPLAY FILES, DISPLAY 
LU, PRINT, and PUNCH commands, and control information for the 
new BIOC CRT driver is presented. A new command (SPOOLF ILE 
command) has been added to enable users of the new spooler, 
SPL/32, to request spooling functions at the CSS or terminal 
level. 


This manual is intended for use with the 0OS/32 R06.2 software 
release and higher. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
GENERAL DESCRIPTION 


1.1 INTRODUCTION 


Multi-Terminal Monitor (MTM) permits several terminal users’ to 
share system resources. Each user perceives that a computer is 
at his or her disposal. 


Concurrent access from online terminals is useful during 
application task development because it reduces turnaround time. 
Other advantages are that concurrent access can be used to extend 
the type of data processing at an _ installation. Using the 
system-supplied interactive software means that editing, task 
development, and documentation can be done simultaneously. 
Furthermore, if the system-supplied interactive tasks are 
supplemented by customer-written tasks, MTM application becomes 
Limitless, supporting a mixture of terminal users such as clerks, 
software development, and operations personnel. 


1.2 MULTI-TERMINAL MONITOR (MTM) OPERATION 

Like all general purpose, multi-access, time sharing systems, MTM 
requires operations involvement from the installation using it. 
This involvement includes those functions that accompany MTM when 


it is tailored to a specific installation along with dynamic 
functions performed when MTM is operating. 


Examples of the MTM tailoring functions are: 


@e Cataloguing authorized users 
e System generation (sysgen) 


e Establishing an installation's procedures 


Examples of dynamic functions are: 


@e System console control 
e Peripheral device supervision 


@ Spooled output dissemination 
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Generally, tailoring functions are performed and maintained by 
the customer's system support group responsible for making 
computing facilities available to system users. The dynamic 
functions are performed by a system operator during system 
operation and are distinct from those functions performed by 
terminal users. 


The system operator can perform all the functions described in 
the OS/32 Operator Reference Manual, together with operator 
functions required to administer MTM. At any time the system 
Operator may be initiating and controlling multiple foreground 
tasks and one background task while operating MIM. 


1.3 USER INFORMATION 


Under MTM control, a terminal user can: 


@ load and execute interactive tasks, 

@e submit multiple batch job requests, 

@e perform program development, 

@e perform program debugging, 

@® create, edit, and manipulate files, 

@ build, modify, and execute command streams, 
@® use spooling functions, 

@ communicate with other terminal users, and 


@e communicate with the system operator. 


A terminal user is either interacting with MTM itself, via 
commands, or interacting with tasks supplied with the system or 
developed by the _ installation. All of the vendor-supplied 
language translators can be operated as interactive tasks by a 
terminal user. Additionally, a terminal user can use the 
vendor-supplied support software programs such as: OS/32 Edit, 
0OS/32 Copy, and OS/32 AIDS. It is the MTM software that performs 
multiple online accessibility; e.g., time sharing, resource 
management, batch scheduling, etc. 


The terminal user can be local or_ remote. The interactive 
terminals for local users are directly connected to the computer 
and do not require telecommunication devices. Interactive 
terminals for remote users require connection via 
telecommunication equipment and data communications) software. 
Basic data communications supports both dedicated and dial-up 
telecommunication terminals. 
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1.3.1 Multi-Terminal Monitor (MTM) Devices 


These devices can be used at any local or remote installation: 


@ Video Display Unit (VDU) 550B — 
e vbuU 1100 

e VDU 1200 

e vbdU 1250 

e vbpuU 1251 

@ Perkin-Elmer SIGMA 10 terminal 
e M33 Teletype 

e M35 Teletype 

e@® Nonediting VDU 

e Carousel 


e Carousel 300 and 300 EFC 


1.3.2 Authorization 


The user must be authorized to use MTM facilities. During the 
signon procedure, the user must supply an account number and a 
password that were previously cataloged within an MTM file called 
the authorized user file (AUF). The AUF is’ updated and 
maintained by an MTM-supplied task that can be initiated only by 
the system operator. The terminal user can then interact with 
MTM from a terminal. 


1.3.3 Privileged Users 


A variety of new capabilities, called privileges, are now 
available to the MTM user. These privileges are associated with 
an account through the AUF utility and are thereafter available 
to any user that signs on to that account. For the purpose of 
delineation throughout the remainder of this manual, any user 
that is signed on to an account which has any or all of these new 
capabilities enabled is called a privileged user. 
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Privileged users may have, in addition to all standard MTM 
capabilities, extended MTM capabilities such as: 


e display all jobs in the batch queue, 


@ move between private accounts without Knowing passwords (SET 
PRIVATE Command), 


e change group account numbers (SET GROUP Command), 


e set the priority of a subsequently loaded task via a private 
CSS (PRIOR Command), 


e interface with a HASP protocol and return to MTM control as 
desired ($HSP), and 


@® interface with a foreground task from an MIM terminal and 
return to MTM control as desired ($FRGND). 


For information on the specific privileges available through MTM 
and the procedures for enabling these privileges on an account 
basis, refer to the OS/32 Multi-Terminal Monitor (MTM) System 
Planning and Operator Reference Manual. 


1.3.4 Transmitting Messages 


MTM can transmit messages between terminal users, between a 
terminal user and the system operator, and from the system 
operator to all or designated terminal users. 


1.3.5 Number of Terminal Users 


An installation can have up to 64 terminal users or 64 concurrent 
batch streams. The sum of terminal users and batch streams 
cannot exceed 64. 


1.4 MULTI-TERMINAL MONITOR (MTM) ENVIRONMENTS 


The MIM terminal user controls a single task at the terminal and 
has the ability to run jobs through batch streams. Using the 
facilities provided by MTM, the user can load a task, start the 
task, and then interact with the task during its execution. MTM 
provides interactive and batch user environments. 


In an interactive environment, the user has the ability to 


interact with a task executing at the terminal. In this 
environment, a dialogue is carried on between the user and the 
task. The interactive task receives user commands and processes 
them. 
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Only one interactive task at a time can be initiated by each MIM 
terminal. However, all interactive tasks initiated by MTM 
terminal users are executed concurrently. During interactive 
task execution, a terminal user can direct a command to and 
receive a response from MTM itself. 


In a batch environment, a number of jobs are run under a full set 
of automated procedures. Once a batch job is accepted for 
execution, no further interaction takes place with the initiating 
terminal user. Requests for multiple batch jobs can be submitted 
by a user, and the same terminal can be used to initiate an 
interactive task. 


Unlike interactive tasks, requests for batch jobs will not 
necessarily be initiated immediately to MTM. Instead, batch jobs 
are queued by the system, and then the queue of submitted batch 
jobs awaiting execution is serviced by the system. The number of 
batch jobs that can be executing concurrently is specified by the 
system operator. 


A terminal user can request one or more batch jobs to be run. 
MTM maintains a queue of submitted batch jobs and concurrently 
processes a number of batch jobs specified during MTM system 
start-up. A terminal user can monitor the progress of a batch 
job by interrogating the MTM batch queue. The returned status 
will be either: 

AWAITING EXECUTION 
or 

EXECUTING 


If a job already has completed execution, the returned status 
will be: 


NO JOBS FOUND 
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1.4.1 Multi-Terminal Monitor (MTM) Terminal Modes 


An active terminal is defined to be in one of six terminal modes. 
The current mode of the terminal determines which, if any, MTM 
terminal commands can be accepted. Thus, it is important for the 
terminal user to be aware of the current mode of the terminal. 
The user terminal is defined to be in one of the following six 
modes: 


e Command mode: No task is loaded, CSS procedure is not 
executing and BUILD is not in effect. All non-task related 
commands are accepted. An "*" is the default prompt displayed 
in this mode. 


e Task loaded mode: The task was loaded but was not started, or 
is paused. An "*" is the default prompt displayed in this 


mode. 

e Task executing mode: A task was started and is executing. If 
started from a CSS, CSS mode is’ suspended. A "-" is the 
default prompt displayed in this mode. If an interactive task 


was started and a data input is requested by the task, then a 
">" is the default prompt displayed to the terminal user. 


e CSS mode: A CSS procedure is being built or executed. A "-" 
is the default prompt displayed in this mode. When a CSS 
terminates, the terminal returns to command mode and a "*" 
prompt is output. When BUILD is in effect, a "B>" is the 
default prompt displayed. 


e Foreground task mode: the terminal has been transferred to 
the control of a foreground task. When the foregound task is 
completed the terminal will return under control of MTM. MTM 
commands are not recognized when in the foreground task mode. 


e Hasp interface mode: the terminal is interfaced with a HASP 
task. The hasp mode prompt is a " and all commands entered 
while in this mode are sent to the specified HASP task. 


1.4.1.1 Interactive Task to Terminal Mode 


When a task issues an SVC 1 I/O operation to an active terminal 
that is in task executing mode and a previous I/O operation to 
that terminal is still pending, MTM treats the I/O as a wait 
operation. This is of no concern for tasks that do SVC 1 wait 
I/O. However, users with tasks that issue SVC 1 proceed I/0 
(read or write) should be aware that MTM suspends the task until 
the I/O is completed. Then MTM posts an SVC 1 proceed I[/0 
completion trap on the task's task queue and allows the task to 
continue. Completion trap posting occurs only if the appropriate 
bit is set in the TSW. 
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1.5 LOADING A TASK 


The dynamic nature of OS/32 memory management guarantees’ loading 
of a task irrespective of its size unless the task is greater 
than the available task memory. If not enough memory is free to 
load a task, then some other task is temporarily rolled out if 
roll support is included in the operating system at sysgen time. 
If MTM is sysgened with roll influence enabled, then MTM 
continually monitors the state of the roll queue to ensure that 
rolled out tasks are given the opportunity to be rolled back in. 
MTM ensures equity for all its terminal operators by assigning 
all the interactive tasks an equal priority. Batch tasks can 
have user assigned priorities. 


1.6 MULTI-TERMINAL MONITOR (MTM) SPECIAL FEATURES 

The following features are designed to make MTM easier and more 
efficient to use: 

e Command substitution system (CSS) 

e Help facility 

@e Program development commands 

@ Spooling 

e Security and access protection of disks 


e@ Signon CSS 


1.6.1 Command Substitution System (CSS) 


A terminal user can build a command file on a disk. Once built, 
a simple directive to MTM will cause MTM to obtain its directives 
from the command file. When invoking the command file, the 
terminal user can supply parameters to the command file that can 
be used to dynamically modify command execution. Therefore, a 
single terminal input can easily initiate complex operations. 


1.6.2 The Help Facility 
The Help facility provides a user online access to documentation 


for MTM and program development commands. This information is 
obtained by entering the HELP command. 
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1.6.3 Program Development Commands 


The program development commands are an integrated set of 
standard CSS procedures that perform two major functions: 


® maintain information that remains constant throughout a 
development effort, and 


e keep files current throughout a development effort in terms of 
checking source, object, and image modules to ensure that 
their dates are current. 


1.6.4 Spooling 


Both input and output spooling are provided for terminal users. 
Tasks never need to be delayed awaiting card readers, card 
punching, or line printing because a batch job can be submitted 
via the Spooler. The job runs unattended and output goes to the 
Spooler. 


1.6.5 Security and Access Protection of Disks 


Privately owned disks can be marked non-restricted by the system 
operator to offer an MTM user complete security and access 
protection of files. The owner of the disk can restrict or 
enable access of the disk to ecther MTM users, the system 
operator, and non-MTM tasks. 


1.6.6 Signon Command Subsitution System (CSS) 


MTM users can build a special CSS file, USERINIT.CSS, within 
their private accounts. The CSS file can contain commands to 
load and start a terminal session, assign logical units, and 
specify a language environment. At signon time, MTM searches all 
online disks within the user's’) private account for the file 
USERINIT.CSS and automatically executes it. 
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L.7 CONVENTIONS 

These conventions used by MTM are detailed in the following 
sections: 

e Prompt conventions 

e@ Terminal conventions 

e Command conventions 

e@ Statement syntax conventions 


e File conventions 


1.7.1 Prompt Conventions 


A prompt is output to a terminal device to indicate that the MTM 
system is ready to accept input from the user. The default | 
prompts displayed on the terminal devices are shown in Table 1-1. 


TABLE 1-1 MTM PROMPT CONVENTIONS 
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accept a command. 


> Indicates a request for input 
data. 
B> Indicates a request for input 


data to be copied to a BUILD 
file. 


i 

i} Indicates that the system is 
| ready to accept a command while 
i; an interactive task is active or 
j} a CSS is running. A new CSS can- 
; not be initiated at this time. A 
| user can instruct MTM to suppress 
} or enable the appearance of this 
} prompt while an interactive task 
} is running, but not while CSS is 
} running. 


Indicates that the terminal is in 
HASP mode. 
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48-043 FOO ROL L=9 


1.7.2 Terminal Conventions 


The conventions in effect for various terminal devices are shown 
in Table 1-2. 


TABLE 1-2 TERMINAL CONVENTIONS 


OPERATION H CONVENT ION 


ed 
a 


| To delete a line, simultaneously de- 
| press the CTRL and character x keys 
| for all terminals except TEC 455 VDU, 
i which uses the number sign (#)-. Basic 
} communications support both # and 
| CTRL x for line deletion for asynchro- 
: nous remote devices. 
i 
t 
Delete a character | To delete a character, depress’ the 
| Backspace key. For terminals without a 
| Backspace key, simultaneously depress 
i the CTRL and character h keys. 
{ 
! 
End an input line | To process an input line, depress’7 the 
;} Carriage return (CR) key. 
{ 
I 
Communicate with MTM ; To communicate with MTM while an 
| interactive task is executing or when 
| a BUILD command is active, depress the 
| Break key and enter a command. 


cM ae ke ae are mn nam A Nene aero sm em see 5 ay SRE on NS ewe me ant ER Me me cri nme samt ele 
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1.7.2.1 Using the Break Key 


If the data request prompt (>) or a BUILD request prompt (B>) is 
displayed and the user wishes to communicate with MTM, depress 
the Break key and the system is ready to accept a command. 


If input or output to the terminal is in progress, the Break key 
interrupts the process. For example, if the DISPLAY or EXAMINE 
command was entered and the output is in progress, depressing the 
Break key halts the output in progress. The system is then ready 
to accept a command. 


If a CSS is currently running, the Break key interrupts’ the 
execution of the CSS. The system is then ready to accept a 
command. Once the command has executed, the CSS will resume 
operation unless the entered command affects the status of the 
css. 
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1.7.3 Command Conventions 


Commands are accepted one line at a time. Multiple commands’ can 
appear on the same line, but each must be separated by a 
semicolon. Multiple commands are executed sequentially. If an 
error is encountered in a multiple command line that was entered 
from a terminal, the commands following the command in error are 
ignored by MIM. For a command line entered from a CSS, the 
commands on the command line are skipped until a $TERMJOB is 
found. A character string preceded by an asterisk in column 1 is 
a comment. 


1.7.4 File Conventions 


A file is a collection of data stored on a direct access’ storage 
device. MTM provides terminal users with the capability of 
creating and editing files in an interactive manner. Once 
created, files remain on the system until they are deleted by the 
owner. However, during the life of a file, ownership can change, 
based on the needs of an installation or project. File ownership 
is established and maintained by MTM via an account number 
mechanism. 


1.7.4.1 Private Account Numbers 


During the signon procedure a terminal user must supply a private 
account number in addition to the correct password. Whenever a 
terminal user allocates a file during an MTM session, the MTM 
system automatically associates the file with the terminal user's 
account number. A file associated with the terminal user's 
account number is referred to as a private file. 


The owner of a private file has unrestricted access to that file 
and can update, execute, access, or delete it as required. 
Furthermore, no other terminal user except users with the correct 
privilege (privileged user) can gain access to another user's 
private files. However, to supply greater flexibility for file 
sharing, MTM supports the concept of group files. 


1.7.4.2 Group Account Numbers 


Authorized MTM terminal users are assigned both a private account 
number and a group account number within the AUF. Unlike the 
private account number, a terminal user is not required to submit 
the group account number during the signon procedure. In fact, 
a terminal user does not need to know the group account number. 
The group account number will generally be the private account 
number of a different authorized terminal user. By using the 
RENAME command and supplying the letter 'G' in the account field, 
a terminal user can change a private file to a group file. 
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As an illustration of the use of group files within an 
installation, consider a normal development activity consisting 
of two or more members working under a project leader's control. 
During the early development phase, each member would probably 
work alone, using private files. However, dQuring the project 
integration phase, the majority of the private files would be 
switched to the project leader's private account number, which 
was defined as the group account for the individual members. 


Once a private file has been switched to a group file, the 
original private owner no longer possesses unrestricted file 


manipulation capability. Instead, the file can be read or 
executed by the original owner and any other terminal user with 
the same group number. Updating or deleting the file can now be 


performed by any terminal user who signs on with the group 
account number. 


Although the use of group files provides a somewhat flexible file 
sharing capability, it does not address the problem of universal 
sharing. For this purpose, MTM supports the concept of system 
files. 


1.7.4.3 System Account Numbers 


In a way similar to switching a private file to a group file, a 
terminal user can supply the letter 'S' in the file account field 
instead of the letter 'G'. The letter 'S’ indicates that 
this private file is now considered a system file. System files 
have an account number of 0. They can be read or loaded by any 
authorized MTM terminal user. However, updating or deleting a 
system file can be performed only by the system operator. 


Within an MTM environment, the system operator is viewed as more 
privileged than terminal users with respect to file ownership. 
The system operator can allocate files on any account in the 
system and can also change the account number of any file in the 
system to any other account number. Similar to a terminal user, 
the system operator uses the RENAME command to change file 
ownership. 

1.7.4.4 File Descriptors (fds) 

File descriptors are required with some commands. A file 
descriptor for MTM generally includes four fields: 

e Disk volume name or device name 

@ Filename 


e File extension 


e File class 
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Format: 


voln: 


Parameters: 


voln: 


f i.lename 


-ext 


48-043 FOO ROL 


filename[. [ext] Ne 
S 


n 


is the name of the disk volume on which the 
file resides, or the name of a device. Voln 
can be from one to four characters. The first 
character must be alphabetic and the remaining 
alphanumeric. This parameter need not be 
specified. If this parameter is not 
specified, the default user volume is used. 
When voln is not specified, the colon 
separating voln and filename must not be 
entered. Where voln refers to a device name, 
a colon must follow the device name, and 
neither the filename nor the extension is 
entered. 


is the name of a file. A filename consists of 
from one to eight alphanumeric characters, the 
first of which must be alphabetic. 


is a l- to 3-character alphanumeric’ string 
preceded by a period specifying the extension 
to a filename. If the period (.) and 
extension are omitted, a default extension is 
appended to the filename if appropriate for a 
particular command, otherwise, it remains 
blank. If the period is specified and the 
extension is omitted, the default is blanks. 


indicates a private file. A private file has 
the same account number as the terminal user's 
current private account number. All of the 
facilities for file manipulation are available 
to the owner of this file. No other user has 
access to this file unless the user has 


certain standard file access privileges 
(privileged user) or, the file is also a group 
file. That is, the user's private account 
number is the same as some other user's) group 
account number. P is the default value if 


neither P, G, nor °§S is indicated in the 
command. 


Examples: 


PACK: FRED. TSK 


FRED. TSK 


ABC: FOO/G 


CARD: 


A:B.C/G 


TEXT. FIL/87 


indicates a group file. A group file, (which 
may also be some other user's private file), 
is accessible to members of that group for 
read only purposes. The group file account 
number in the AUF indicates to the system 
which users can access this group file. 


indicates a system file. A system file has 
account number 0. A terminal user can only 
read a system file. 


privileged users that have the privilege to 
specify account numbers’ instead of account 
class designators (P, G, and S) can do so for 
some commands such as ASSIGN, LOAD, RENAME, 
and CSS calls. Access is limited to SRO if n 
is not the user's private account. 


is a private file FRED.TSK on volume 
PACK. 


is the same file as in the previous. 
example, if PACK is the default user 
volume (private file). 

is a group file with filename FOO 
with default extension, on volume 
ABC. 

is a device name. 


is a group file B, with extension C 
on volume A. 


is a file on the default user volume 
in account 87. 
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CHAPTER 2 


MULTI-TERMINAL MONITOR (MTM) USER COMMANDS 


2.1 INTRODUCTION 


The following steps comprise a basic MTM terminal session: 


SIGNON MAR, 118,SWDOC 


V M300 


LOAD EDIT32 


START 


S FILEL 
END 


SIGNOF 
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Identify yourself to MTM by) signing 
on to the system. Enter your 
userid, account number, and a valid 
password. 


Establish the volume you will be 
working on by entering the VOLUME 
command and a valid volume name. 


Load the editor task into memory by 
entering LOAD and the task name. 


Initiate execution of the task 

by entering the START command. 

Save all data appended to your file 
by entering the SAVE command. 


Terminate execution of the task by 
entering END. 


End the terminal session by signing 
off. 


7 em ne ee ae ee eS ee 


2.2 ALLOCATE COMMAND 


The ALLOCATE command creates a direct 
communications Line control block for 
manager. 
Format: 


CONTIGUOUS, mi 


ALLOCATE fd, 


ere rail i i 


access file OL a 
a buffered terminal 


Parameters: 


fd is the file descriptor of the device or file 
to be allocated. 

CONT IGUOUS specifies that the file type to be allocated 
is contiguous. 

fsize is a decimal number indicating file size which 
is required for contiguous files. It 
specifies the total allocation size in 


256-byte sectors. 
up to the 


existing on the specified volume at’ the 
the command is entered. 


Na 
i 
No 


This size may be any 
number of contiguous free sectors 


value 


time 
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keys 


EC 


bsize 


isize 


INDEX 


Lrecl 


NB 


I TAM 
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specifies the write and read protection keys 
for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
signifies the write key and the right byte, 
the read key. If this parameter is omitted, 
both keys default to O. 


specifies that the file type to be allocated 
is extendable contiguous. 


is a decimal number specifying the number of 
256-byte sectors contained in a physical block 


to be used for buffering. This parameter 
cannot exceed the max imum block size 
established at sysgen time. If bsize is 


omitted, the default value is one sector for 
indexed files and 64 sectors for extendable 
contiguous (EC) and nonbuffered (NB) indexed 
files. When the file type is ITAM, bsize is 
the buffer size in bytes. 


is a decimal number specifying the indexed 
block size. If isize is omitted, the default 
value is one sector for indexed files’ and 
three sectors for EC and NB files. Like 
bsize, isize cannot exceed the maximum block 
size established at sysgen time. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number’ specifying the logical 
record length of an indexed file, nonbuffered 
indexed file, or [TAM device. It cannot 
exceed 65,535 bytes. Its default is 126 
bytes. It may optionally be followed by a 
slash (/) which delimits'9 lrecl from bsize. 


For NB files, this number must be even. 


specifies that the file type to be allocated 
is nonbuffered indexed. 


specifies that the device to be allocated is 
a communications device. 


Functional Details: 


The MTM user can only allocate files in their private account. 
To assign an indexed file, sufficient room must exist in system 
space for two buffers, each of the stated size. Therefore, if 
bsize or isize is very large, the file might not be assignable in 
some situations. At sysgen time, a maximum block size parameter 
is established in the system, and bsize cannot exceed this 
constant. 


To assign an EC or NB file, sufficient room must exist in system 
space to contain only the index block of the stated size. The 
data blocks for EC and NB files are not buffered in system space 
and thus are not constrained to the sysgened block size. 


The ALLOCATE command can be entered in command mode, task loaded 
mode, and task executing mode. 


Examples: 


AL JANE.TSK,CO, 64 Allocates, on the default user 
volume, a contiguous file named 
JANE.TSK whose total length is 64 
sectors (16kb) with protection 
keys of O. 


AL M300:AJM.BLK, IN, 132/4 Allocates, on volume M300, an 
indexed file named AJM.BLK with 
logical record length of 132 
bytes, data block size of four 
sectors, and default isize of one 
sector. The protection keys 
Gefault to 0. When this file is 
assigned, the system must have 
2.25kb of available system space 
for buffers. 


AL THISFILE, IN, 256/4/2 Allocates, on the default user 
volume, an indexed file named 
THISFILE (blank extension) with a 
logical record length of 256 
bytes, a data block size of four 


sectors, an index block size of 
two sectors, and protection keys 
of O. 

AL VOT.1:AJM.OBJ,IN,126 Allocates, on volume VOL1, an 


indexed file named AJM.OBJ whose 
logical record length is 126 
bytes. The buffer size and 
indexed block size default to one 
sector and the protection keys 
default to O. 
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AL VO1:AJM.OBJ,IN,126//3 


AL SYS:XFILE.DTA,EC 


AL YFILE.DAT,NB,240/250/5 
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Allocates, on volume VOl, an 
indexed file named AJM.OBJ with 
logical record length of 126 
bytes. The data block size 
defaults to one sector, the index 
block size is three sectors, and 
the protection keys default to O. 


allocates on volume SYS an 
extendable contiguous file named 
XFILE.DTA with default data block 
size of 64 and index block size of 
3 sectors. The file initially 
contains no records, and has a 
record length of one sector (same 
as a contiguous file). 


allocates on the default volume a 
nonbuf fered indexed file named 
YFILE.DAT with logical record 
length of 240 bytes, data block 
size of 250 sectors, and index 
block size of 5 sectors. The file 
initially contains no records. 


2.3 ASSIGN COMMAND 


The ASSIGN command assigns a device, file, or communications 
device to one of a task's logical units. 


Format: 


ASSIGN lu,fd 


Parameters: 


lu 


fd 


access 
privileges 


keys 


td 


access privileges SVC15 


is a decimal number’ specifying the logical 
unit number to which a device or file is to be 
assigned. 


is the file descriptor of the device or file 
to be assigned. 


are the desired access privileges. The 
default access privileges are: 
- SRW for contiguous files 


- SREW for indexed, nonbuffered indexed, and 
extendable contiguous files 


- SRO for any files that are not the _ users’ 
private files 


- ERW for devices (except the users' console. 
This has SRW.) 


signifies the read/write protection keys of 
the file or device to be assigned. 
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SVC1L5 signifies that the specified device is to be 

SVCF assigned for SVC 15 access. SVCF is the 
hexadecimal equivalent of SVC15 and can also 
be specified. This option pertains to 
communications devices only. If SVC 15 access 
is specified, neither vertical forms control 
nor tape density can be specified. 


VFC specifies the use of vertical forms’ control 
for the assigned lu. If this parameter is 
specified, SVC15 access or tape density 
selection cannot be specified. If this 
parameter is omitted, there is no vertical 
forms control for the device assigned to the 
specified lu (unless the task was linked with 
the VFC option). 


HI indicates that the assigned magnetic tape will 
operate at the GCR density rate of 6250 bpi. 


T.OW indicates that the assigned magnetic tape will 
operate at the NRZI density rate of 800 bpi. 


MED I UM indicates that the assigned magnetic tape will 
operate at the PE density rate of 1600 bpi. 


Functional Details: 


If the access privileges and keys parameters are omitted and VFC, 
SVC15, HI, LOW, or MEDIUM are specified, the positional commas 
belonging to the omitted parameters can be omitted. 


‘Tf the access privileges and VFC, SVC15, HI, LOW, or MEDIUM 
parameters are specified and the keys parameter is omitted, the 
positional comma belonging to the keys parameter can be omitted. 


Access privileges can be one of the following: 


SRO sharable read-only 

ERO exclusive read-only 

SwWO sharable write-only 

EWO exclusive write-only 

SRW sharable read/write 

SREW sharable read, exclusive write 
ERSW exclusive read, sharable write 
E RW exclusive read/write 


If the file is not in the user's private account, only the SRO 
access privilege is valid. 


When the SVCL5 option is specified, only SRW, SREW, ERSW, and ERW 
access privileges are accepted. 
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The DISPLAY LU command can be used to determine the current 
access privileges of all assigned units. 


The ASSIGN command is rejected if the requested access’ privilege 
cannot be granted. 


When a task assigns a file, it might want to prevent other tasks 
from accessing that file while it is being used. For this 
reason, the user can ask for exclusive access privileges, either 
for read or for write, at assignment time. This is called 
dynamic protection because it is only in effect while the file 
remains assigned. 


A file cannot be assigned with a requested access privilege if it 
is incompatible with some other existing assignment to that file. 
A request to open a file for exclusive write-only is compatible 
with an existing assignment for SRO or ERO, but is incompatible 
with any existing assignment for other access privileges. Table 
2-1 illustrates compatibilities and incompatibilities between 
access privileges. 


TABLE 2-1 ACCESS PRIVILEGE COMPATIBILITY 


| ERSW | ERO {| SRO {| SRW {| SWO {| EWO | SREW | ERW | 


— 


i 
' 
i 
i 
i 
i 
! 
i 
| 
i 
i 
} 
i 
i 
i 
| 


L_LEGEND 


* compatible 
- incompatible 
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The keys format is a 4-digit hexadecimal number. The left two 
digits signify the write protection key and the right two digits, 
the read protection key. If omitted, the default is 0000. These 
keys are checked against the appropriate existing keys for the 
file or device. The command is rejected if the keys are invalid. 
The keys associated with a file are specified at file allocation 
time. They may be changed by a REPROTECT command or through an 
SVC 7 reprotect function call. 


If the values of the keys are within the range X'Ol1' to X'FE', 
the file or device cannot be assigned for read or write access 
unless the requesting task supplies the matching keys. If a key 
has a value of X'00', the file or device is unprotected for that 


access mode. Any key supplied is accepted as valid. If a key 
has a value of X'FF', the file is unconditionally protected for 
that access mode. It cannot be assigned for that access mode to 


any user task, regardless of the key supplied. 


Examples: 


WRITE READ 


KEY KEY MEAN ING 

00 00 Completely unprotected 

FF FF Unconditionally protected 

07 00 Unprotected for read, conditionally 
protected for write (user must 


supply write key=X'07') 


FF A7 Unconditionally protected for write, 
conditionally protected for read 


00 FF Unprotected for write, uncon- 
ditionally protected for read 


27 32 Conditionally protected for both 
read and write 


An assigned direct access file is positioned at the end of the 
file for access privileges SWO and EWO. It is positioned at the 
beginning of the file for all other access’ privileges. The 
command is rejected if the specified lu is already assigned. To 
reassign an lu for an active task, the lu must first be closed. 


If one of the HI, LOW, or MEDIUM parameters is not chosen when 
assigning to a mag tape device, the standard default density is 
used. The default used is dependent upon the type of tape drive 


in use. Note that if this parameter is used to select the 
density of the assigned mag tape, SVC 15 or VFC access cannot’ be 
specified. The HI, LOW, and MEDIUM parameter options are 


positionally independent. 
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The ASSIGN command can be entered in task loaded mode. 


Examples: 


AS 2,FILE.DAT,EWO,99AA 


AS 


AS 


AS 


AS 


AS 


AS 


AS 


2,TEST.JOB,VFC 


2,TEST.JOB, ’ ,VFC 


2,TEST.JOB,,VFC 


2,TEST.JOB,SRO,VFC 


2,MAG1:,LOW 


2,MAG1: ,SRW,MEDIUM 


2,MAG1:,,,HI 


Assigns a disk file to lu2. The EWO 
access privilege causes the file to 
be positioned at the end. It is 
conditionally protected with write 
and read keys of 99AA. New records 
are appended. 


Assigns a disk file to lu2. 
Vertical forms control is in use. 
Access privileges and keys 
parameters are omitted along with 
their respective commas. 


Assigns a disk file to lu2. 
Vertical forms control is in use. 
Access privileges and keys 
parameters are omitted but 
positional commas are specified. 


Assigns a disk file to lu2. 
Vertical forms control is in use. 
The positional comma belonging to 
the omitted access privileges 
parameter must be specified. 


Assigns a disk file to lu2. 
Vertical forms control is in effect. 
The keys parameter, along with the 
positional comma, is omitted. The 
privilege is shared read only. 


Assigns a mag tape drive to 1lu2. 
The LOW parameter indicates that the 
drive will operate at the NRZI 
density rate of 800 bpi. 


Assigns a mag tape drive to lu2. 
The MEDIUM parameter indicates that 
the drive will operate at the 
Perkin-Elmer density rate of 1600 
bpi. 


Assigns a mag tape drive to lu2. 
The HI parameter indicates that the 
drive will operate at the GCR 
density rate of 6250 bpi. Access 
privileges and keys parameters are 
omitted, but positional commas are 
specified. 
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Invalid Examples: 


AS 2,TEST.JOB,OOFF,VFC 


Invalid assignment because the 
positional comma belonging to the 
omitted access privileges parameter 
must be specified. 


AS 2,TEST.JOB,SRO,VFC,SVC15 


AS 2,MAG1:,SRW,LOW,SVCF 
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Invalid assignment because vertical 
forms control and SVC 15 access are 
mutually exclusive and cannot be 
specified in the same assignment. 


Invalid assignment because tape 
density and SVCF access are mutually 
exclusive and cannot be specified in 
the .same ASSIGN command. 


2.4 BFILE COMMAND 


The BFILE command backspaces to the preceding filemark on 
magnetic tapes, cassettes, and direct access files. 


Format: 
BFILE [fd,] lu 


Parameters: 


fd is the file descriptor of the device or file 
to be backspaced to a filemark. 


lu is the lu to which the file is assigned. If 
lu is specified without fd, the operation is 
performed on the lu regardless of what is 
assigned to it. 


Functional Details: 


The BFILE command can be entered in task loaded mode. 


Examples: 
BF 1 Causes the device or file assigned 
to lul to backspace one filemark. 
BF M300:AJM.OBJ, 4 Causes file AJM.OBJ, that is 


assigned to lu4 on volume M300:, to 
backspace one filemark. 
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2.5 BIAS COMMAND 


The BIAS command sets a base address for the EXAMINE and MODIFY 
commands. 


Format: 


Parameters: 


address is a hexadecimal bias to be added to the 
address given in any subsequent EXAMINE or 
MODIFY command. For a u-task, the address 
must be a valid address that exists for the 
u-task. For an e-task, the address can be any 
valid address in the system. The addresses 
must be aligned ona halfword boundary. If 
address is omitted, it is assumed to be _ the 
beginning of the task. 


x sets bias to O for a u-task and to the 
physical load address for an e-task. 


Functional Details: 

A BIAS command overrides all previous BIAS commands. The user 
should enter a BIAS command if the current value is unknown. 

The BIAS command can be entered in task loaded mode and task 
executing mode. 


Example: 


BI 100 Sets bias to 100 
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2.6 BREAK COMMAND 


The BREAK command returns a break status (X'8200') to a task with 
an outstanding I[/0 on the MTM terminal. 


Format: 


BREAK 
Functional Details: 


The BREAK command can be entered in task executing mode. 
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2.7 BRECORD COMMAND 
The BRECORD command backspaces to the preceding record on 
magnetic tapes, cassettes, and direct access files. 
Format: 
BRECORD [fd,] lu 
Parameters: 
fd is the file descriptor of the device or file 


to be backspaced one record. 


lu is the lu to which the file is assigned. If 
lu is specified without fd, the operation is 
performed on the lu regardless of what is 
assigned to it. 


Functional Details: 
The BRECORD command can be entered in task loaded mode. 
Examples: 


BR 1 . Causes the device or file assigned 
to lul to backspace one record. 


BR M300:AJM.OBJ,4 Causes the file AJM.OBJ, assigned to 
lu4 on volume M300, to backspace one 
record. 
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2.8 BUILD AND ENDB COMMANDS 


The BUILD and ENDB commands copy data from the command input 
device to the fd specified in the BUILD command. 


Format: 


Parameters: 


fd 


Lu 


APPEND 


is the file descriptor of the device or file 
to which data is copied. If fd does not 
contain an extension, .CSS is used as a 
default. If a blank extension is desired, the 
period following the filename must be typed. 
If fd refers to a direct access file, an 
indexed file by that name is allocated with a 
logical record length equal to the command 
buffer length established at sysgen time, a 
blocksize of 1, and keys of 0000. If the 
specified fd already exists, that fd is 
deleted and a new fd is allocated. 


is the lu to which data is to be copied. A 
temporary file is allocated and the BUILD data 
is copied to Lt. When the ENDB is 


encountered, the temporary file is assigned to 
the specified lu of the loaded task. This 
form of the BUILD command is only valid when 
a task is loaded. 


allows the user to append data to an existing 


fd. EE the fd does not exist, it is 
allocated. 
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Functional Details: 


Lines entered from the terminal after the BUILD command are 
treated as data, and are copied to the specified device or file 
until an ENDB command is encountered. ENDB may be followed by 
other commands in the command line. Data following the ENDB 
command is treated as a command. If any data follows the BUILD 
command on the same line, it is treated as a comment and no 
action is taken. The BUILD command can be entered from the 
terminal only if a CSS is not active. It can be entered in 
command, task loaded, and task executing modes. 


Example: 
BUILD ASSN 
AS 1, CR: 
AS 2, OUT.OBJ 
AS 3, PR: 
AS 5, CON: 
ENDB 
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2.9 CANCEL COMMAND 
bite CANCEL command terminates a task with an end of task code of 
Format: 
CANCEL 
Functional Details: 
The normal response to this command is: 


Signon name END OF TASK CODE=255 CPUTIME=ut ime/ost ime 


The CANCEL command can be entered in task loaded mode and task 
executing mode. 
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2.10 CLOSE COMMAND 


The CLOSE command closes (unassigns) one or more files or devices 
assigned to the currently selected task's logical units. 


Format: 
lu, [;lup,..-, lun] 
CLOSE 
ALL 
Parameters: 
lu decimal numbers signifying the logical units 
to be closed. 
ALT. | specifies that all logical units of the task 


are to be closed. 


Functional Details: 


Closing an unassigned lu does not produce an error message. A 
CLOSE command can only be entered if the task is dormant or 
paused. 


The CLOSE command can be entered in task loaded mode. 


Examples: 


GL 1,375 Closes logical units 1, 3, and 5 of 
the task. 

CLOSE A Closes all logical units of the 
task. 
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2.11 CONTINUE COMMAND 


The CONTINUE command causes Aa paused task to resume operation. 


Format: 
CONTINUE [address] 


Parameter: 


address is a hexadecimal number that specifies where 
the task is to resume operation. If this 
parameter is not specified or is 0, the task 
resumes at the instruction following the 


pause. 


Functional Details: 


The CONTINUE command can be entered in task loaded mode. 
Executing this command causes the terminal mode to be switched 
from task loaded mode to task executing mode. 
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2.12 DELETE COMMAND 


The DELETE command deletes a direct access file. 
Format: 


DELETE fd_ [- £4, reseed] 


Parameter: 
fd identifies the file(s) to be deleted. 
Functional Details: 


The file being deleted must not be currently assigned to an lu of 
any task. A file can be deleted only if its write and _ read 
protection keys are 0 (X'0000'). If the keys are nonzero, they 
can be changed using the REPROTECT command. Only private files 
can be deleted. 


The DELETE command can be entered in command mode, task loaded 
mode, and task executing mode. 
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2.13 DISPLAY COMMAND 


The DISPLAY command is used to display new global or new internal 
variables currently defined by the user. This command will not 
display local variables or global variables. 


Format: 
n,/Ny, 
GVARIABLE fa 

DISPLAY | <n r 

IVAR TABLE 
Parameters: 

GVARIABLE indicates that the variables to be displayed 
are new global variables. 

IVARIABLE indicates that the variables to be displayed 
are new internal variables. 

ny /No specifies that all variables (of the type 
selected via the preceding parameter) between 
the range n; to no be displayed. Where n_ is 
a decimal number between 1 and the maximum 
value allowed at MTM sysgen for the variable 
type selected. 

n is the decimal number of a specific variable. 
n must be between 1 and the maximum value 
allowed at MTM sysgen for the variable type 
selected. 

ALL specifies that all new global or new internal 
variables be displayed. This is the default 
if no specific variable numbers are entered. 

fd is a file descriptor of a file or device to 


which the display is to be output. The 
default for this parameter is’ the users 
console. 
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Functional Details: 

The DISPLAY command can be used in command mode, task loaded 
mode, and task executing mode. 

The current value of each variable is displayed in the DISPLAY 
command display. 


Examples: 


Example 1 illustrates a means of displaying all new global 
variables currently defined by the user. 


*DISPLAY GVARIABLE 


GV# NAMB «26: 2:3 VAIUE se) cai Sei we te ee 0 eer a ase: Se a Wk eS a Ss ede eg oi we 
GOl SOURCE TEST.FTN/P 

G03 LISTDEV SCRT:TEST.LST/P 

G04 BATCH OPTIM XREF 


Example 2 illustrates a means of displaying information about new 
global variable 3. 


*DISPLAY GVARIABLE, 3 


GV# NAME. a3 « VALUES. 6 ios, hea aoe MAR eRe eee eee ce Dewees es 
G03 LISTDEV SCRT:TEST.LST/P 


Example 3 illustrates a means of displaying all new global 
variables between 2 and 5. 


*DISPLAY GVARIABLE, 2/5 


GV# NAMB ©. oce:s VATGUB og ote ts so Sm 6 Soi yO sek wR BS ela aw erie 8 we eg eg cae Bw SS 
G03 LISTDEV SCRT:TEST.LST/P 
G04 BATCH OPTIM XREF 


48-043 FOO ROL 7293 


{ DISPLAY 

i ACCOUNTING 

2.14 DISPLAY ACCOUNTING COMMAND 

The DISPLAY ACCOUNTING command displays accounting data collected 


for a currently running or previously run task. 


Format: 


fd 


DISPLAY ACCOUNTING |, 


Parameter: 


fd is the file descriptor to which the accounting 
information is displayed. The user console is 
the default. 


Functional Details: 


The DISPLAY ACCOUNTING command displays this information: 


USER TIME hh:mm:ss.ms 
SVC TIME hh:mm:ss.ms 
WAIT TIME hh:mm:ss.ms 
ROLL TIME hh:mm:ss.ms 
I/O n 
ROLLS n 


The DISPLAY ACCOUNTING command can be entered in command wmode, 
(providing at least one task has been run during the current 
terminal session), task loaded mode, and task executing mode. 
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DISPLAY 
DEVICES | 


2.15 DISPLAY DEVICES COMMAND 
The DISPLAY DEVICES command displays to the specified fd the 


physical address, keys, online/offline state, and the volume name 
(for online direct access devices) of all devices in the system. 


Format: 


fd 


DISPLAY DEVICES ; , 


Parameter: 


fd is the file descriptor specifying the file or 
device to which the display is routed. If fd 
is omitted, the default is the user console. 


Functional Details: 


The DISPLAY DEVICES command can be entered in command mode, task 
loaded mode, and task executing mode. 
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D D 

NAME DN KEYS 

NULL 0 0000 D300 FC 0000 M300 CD 
D301 Dc 0000 M301 CD D67A EC 0000 M67A CD 
D67B ED 0000 MIM SYS CD DO5A C6 0000 OFF 

DO58 C7 0000 FIXD CD MAG2 95 0000 

MAG3 C5 0000 MAG4 D5 0000 

CON 2 0000 CR 4 0000 

PRT 63 0000 PR 0 0000 SPOL 

PRL 0 0000 SPOL CT34 34 0000 

CT36 36 0000 _ ¢T3c 3c 0000 

CT42 42 0000 CT46 46 0000 

cT4ac 4c 0000 CT72 72 0000 

CT74 74 0000 CT7A 7A 0000 

cT7C 7¢C 0000 IT7E 7E 0000 ITAM 

DI18 18 0000 + ITAM BI18 18 0000 

BOLA B8 0000 # ITAM BQ2A B8 0000 ITAM 

BO3A B8 0000  ITAM BQPA B8 0000 # ITAM 

BOLB BC 0000 # ITAM BQ2B BC 0000 ITAM 

BQ3B BC 0000 ITAM BOPB BC 0000 # £ITAM 


IRDR: % % % kk ok ke 


In the DISPLAY DEVICES output the screen or page is divided in 
half in order to display more devices per page (or screen). The 
definition of the columns is applicable to either half of the 
display. Columns 1, 2, and 3 contain the device name, device 
number (address), and keys, respectively. Column 4 is only 
defined for pseudo-print (spool), ITAM (communications), and 
direct access devices. The characters SPOL specify that the 
devices are pseudo-print devices used in spooling. 


For direct access devices, column 4 contains the characters OFF 
to indicate that the device is offline. If online, the volume 
name is output in column 4. For write-protected disks, column 5 
contains the characters’ PROT. For MTM users, if the disk is 
write-protected, column 5 contains the characters SYS. If the 
disk is restricted, column 5 contains the characters RES. If the 
secondary directory option is enabled, the last column contains 
the characters CD. 


Pseudo devices created by the SVC intercept facility are 
displayed as a file descriptor with asterisks filling the 
filename and extension fields. As an example, all SPL/32 spooler 
pseudo devices are displayed in this manner. 
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2.16 DISPLAY DFLOAT COMMAND 


The DISPLAY DFLOAT command displays’ to 
contents 


of the 


fd the 
registers 


the specified 


double precision floating point 


associated with the loaded task. 


Format: 


DISPLAY DFELOAT 


Parameter: 


fd 


Functional Details: 


The user-specified task should have been built with the 


fd 


t 


is the file descriptor specifying the file or 
device to which the contents of the double 
precision floating point registers associated 
with a user-specified task are displayed. If 
fd is omitted, the default is the user 
console. 


DFLOAT 


option at Link time. 


The DISPLAY DFLOAT command can be entered in task loaded and task 
executing mode. 


Example: 


00000000 
00000000 
00000000 
00000000 
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00000000 00000000 00000000 
00000000 00000000 00000000 
00000000 00000000 00000000 
00000000 00000000 00000000 


ee ee ee 


2.17 DISPLAY FILES COMMAND 


The DISPLAY FILES command permits information from the directory 
more direct access files to be output to a specified 


of 
fd. 


one 


Format: 


or 


DISPLAY FILES , 


Parameters: 


voln: 


Please 


voln: [filename] [- [ext] ] 


default user vol 


crc oO BZ QW 


NOTE 


see Functional Details for 


variations on the DISPLAY FILES command 


syntax. 


specifies that all files with the user account 
number be displayed regardless of what volume 
they reside on. Entering the colon with part 
of a filename limits the file search to 
filenames with the specified characters. 


is a l- to 4-character name of a disk volume. 
The first character must be alphabetic, the 
remaining alphanumeric. If voln is omitted, 
the default is the user volume. 
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filename is a l- to 8-character name of a file. The 
first character must be alphabetic, the 
remaining, alphanumeric. . 


ext is a 1l- to 3-character extension to the 
filename. 
P indicates that information is requested for a 


private file. 


Ss indicates that information is requested on a 
system file; default is private files only. 


G indicates that information is requested for a 
group file; default is private files only. 


N indicates that information is requested for 
private and group files. 


O indicates that information is requested for 
group and system files. 


L indicates that information is requested for 
private and system files. 


fd is the file descriptor specifying the file or 
the device to which the display is output. If 
fd is omitted, the default is the user 
console. 


Functional Details: 


A hyphen (-) in the command format requests that all files 
starting with the characters preceding the - or following the - 
are displayed, subject to any restrictions specified in the 
extension, account number, and fd fields. For example: 


CAL32- displays all files whose first five characters 
are CAL32. 

CAL32.- displays all files named CAL32 with any 
extension. 

-.MTM displays all files with the the extension MTM. 

CH-.043 displays all files beginning with CH, with an 


extension of 043. 
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The character * requests that all files with matching characters 
in the same position(s) as those entered are displayed. For 
example: 


CAL32* ** displays all files between five and eight 
characters in length whose first five 
characters are CAL32. 


CAL* *CAL Gisplays all files, with a filename eight 
characters long, whose first three and last 
three characters are CAL. 


***x*32 OBI displays all files with a filename containing 
six characters whose fifth and sixth 
characters are 32 and whose extension is .OBJ. 


An asterisk in the account position indicates that all accounts 
are to be searched for amatch. If the user is a privileged 
user, every account on the system is checked. If the user is a 
nonprivileged user, the P, G, and S accounts are checked. 


The characters * and - can be combined in the command format, as 
described previously, to further delimit files displayed. For 
example: 


CAL* *1- displays all files whose first three 
characters are CAL, and whose sixth character 
is l. 

See F382 .0 displays all files, eight characters’ long, 


whose last two characters are 32 and whose 
extension begins with an 0. 


A colon entered with part of a filename and a dash displays all 
filenames with the user account number starting with the 
specified characters, regardless of what volume they reside on: 


DF, :JM- 


A colon entered with a specified extension displays all files 
under the user account number with the specified extension, 
regardless of what volume they reside on: 


D F,:.JM 
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An example of the display produced by the DISPIAY FILES 
from a privileged user is: 


M300:-.- 


VOLUME= M300 
FILENAME..... 
SYSEDIT .CMD/00205 IN 


TEST -CSS/00205 IN 
CONTIG 700205 CO 
IN : /00205 IN 


l/l 
l/l 


10/3 


80 
132 


50 


TY DBS/IBS RECL. RECORDS 


1 
2 
35 
0 


CREATED. 
11/10/82 
11/15/82 
11/15/82 
11/15/82 


command 


LAST WRITTEN. . 


11/10/82 
11/15/82 
11/15/82 
11/15/82 


22:30 
11:30 
11:35 
11:35 


KEYS 
0000 
0000 
0000 
0000 


An example of the same DISPLAY FILES 
user is: 


command from a nonprivileged 


DF, M300:-.-/P 


VOLUME= M300 


FILENAME...... TY DBS/IBS RECL. RECORDS CREATED....... LAST WRITTEN.. KEYS | 
SYSEDIT .CMD/P IN l/l 80 1 11/10/82 22:30 11/10/82 22:30 0000: 
TEST -CSS/P IN l/l 132 2 11/15/82 11:30 11/15/82 11:30 0000. 
CONTIG. /P co 35 11/15/82 11:35 11/15/82 11:35 0000 
IN ‘ /P IN 10/3 50 O 11/15/82 11:35 11/15/82 11:35 0000. 


For contiguous files, TYPE (TY) is CO, 
the file in (decimal) sectors. 


and RECORDS is the size of 


For indexed files, TYPE is IN, followed by the data and index 
blocking factors, RECL is the logical record length in (decimal) 
bytes, and RECORDS is the number of logical records (in decimal) 
in the file. 


For nonbuffered indexed files, TYPE is NB, RECL is logical record 
length in (decimal) bytes, and RECORDS is the number of logical 
records (in decimal) in the file. 


For extendable contiguous files, TYPE is EC, and RECORDS is 
length of the file in sectors (i.e., the size of the file). 


the 


Spool and temporary files are named as *SPOOLFILE* and *TEMPFILE* 
respectively (unless the user has the privilege to see the actual 
filenames, in which case, the names are displayed). 
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The DISPLAY FILES command can be entered in command mode, task 
loaded mode, and task executing mode. 


NOTE 


If a DISPLAY FILES command is entered by 
a privileged user, the account number of 


each file 


displayed. Nonprivileged 


MTM users see the account class (P, G, or 


S). 


Examples: 


DF 


D F,CAL32.TSK/- 


D: -F ,-7> 


D F,,MAGI: 


D F,M300: 


D F,M300:A-.TSK 


D F,-.,PRIL: 


D F,CAL**1-.- 


displays to the user terminal all 
files with the user's account number 
on the default user volume. 


Gisplays file CAL32.TSK in the 
private, group, and system accounts. 


displays all files in the private 
group and system accounts on the 
default user volume. 


displays, to the device MAGI, all 
files with the user's account number 
on the default user volume. 


displays, to the user's terminal, 
all files with the user's account 
number on volume M300. 


displays all files on volume M300 
with first character A and extension 
TSK in the user's account number. 


displays all files on the default 
user volume in the user's account 
number with blank extension, 
regardless of filename. The display 
is routed to device PR1:. 


displays, to the user's’ terminal, 
all files that start with CAL, 
contain the character 1 in the sixth 
position, have any extension and are 
in the user's account number. 
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D F,M-: TASK. 5* 


D F,-:TASK.- 


D F,-:EDIT-/* 


D F,-/N 
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displays to the user's terminal the 
files mamed TASK that have one or 
two character extensions starting 
with the character 5. A separate 
display of these files is done for 
each online disk volume whose name 
starts with the letter M. 


displays to the user's terminal the 
files named TASK, with any 
extension. A separate display of 
these files is done for each online 
disk volume in the system. 


displays all files that start with 
the four characters EDIT, on all 
volumes, in all accounts, regardless 
of the extension. If the user is 
not privileged, only matching files 
in the private, group, and system 
accounts are displayed. 


displays all files in the user's 
private and group account on the 
Gefault users volume. 


2.18 DISPLAY FLOAT COMMAND 
The DISPLAY FLOAT command displays to the specified fd the 


contents of the single precision floating point registers 
associated with the loaded task. 


Format: 


DISPLAY FLOAT E os 


Parameter: 


fd is an optional file descriptor specifying the 
file or device to which the display is output. 
If fd is omitted, the display is output to the 
user's terminal. 


Functional Details: 


The user-specified task must. be built with the FLOAT option 
specified at Link time. 


The DISPLAY FLOAT command can be entered in task loaded mode. 


DF 

0,2 00000000 00000000 
4,6 00000000 00000000: 
8,A 00000000 00000000 
C,E 00000000 00000000 
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2.19 DISPLAY LU COMMAND 
The DISPLAY [I.U command displays to the specified fd all assigned 
logical units of the loaded task. 


Format: 


DISPLAY LU |, 


Parameter: 


fd is an optional file descriptor specifying the 
file or device to which the assigned logical 
units are to be displayed. If fd is omitted, 
the default is the user console. 


Functional Details: 


The lu number, file or device name, current access’ privileges, 
current record number, and percentage thru file are displayed. 
The current record number and percentage thru file are displayed 
only for files. 


L FILE/DEVICE RECORD THRU 
M67A: RADPROC.CSS/000,SRO 30 15.0% 
CON: , SRW 
CON: , SRW 


CON: , SRW 


Onwe G 


M67A:RADPROC.CSS/000,SRO 200 100.0% 
CON: , SRW 
M67A:&2614586.001/000,SREW 1 100.0% 
CON: , SRW 
CON: , SRW 


Om» & PE 
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The DISPLAY LU command can 
task executing mode. 


Example: 


DISP LU,PR: 


be entered in task loaded mode _ and 


Displays assigned logical units to 
the printer device (PR:). 
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DISPLAY 


{ 
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PARAMETERS 


2.20 DISPLAY PARAMETERS COMMAND 


The DISPLAY PARAMETERS command displays the parameters 
loaded task. 


Format: 


DISPLAY PARAMETERS | 


Parameter: 


fd 


is an optional file descriptor specifying 


of 


the 


the 


file or device to which the display is output. 
is omitted, the default is the user 


If fda 


console. 


Functional Details: 


Table 2-2 lists the field addresses and data displayed when 


DISPLAY PARAMETERS command is entered. 


48-043 


TABLE 


| FIELD | 


2-2 DISPLAY PARAMETERS COMMAND FIELDS 


VALUE 


MEAN ING 


— ee 2 2 ee 2 ee  —— -  e  d 


TASK | 


CTSW 


STAT 


| CLOC 
| TOPT 


USSP 
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XXXXXXXX 


XXXXXXXX 


XXXXX 


XXXXX 


XXXXXXKX 


XXXXX 


! 
' 
' 
t 
{ 
| 
' 
' 
| 
' 
! 
t 
{ 
' 
{ 
1 
' 
4 
' 
! 
' 
‘ 
{ 
t 


Task name, also user signon 
name 


Status portion of current TSW 
Current location 

Task wait status 

Task options 


Current used system space 


the 


TABLE 2-2 DISPLAY PARAMETERS COMMAND FIELDS 


(Cont inued) 
| FIELD | VALUE {MEANING = 
| MUSP {  xxxxx | Maximum used system space | 
| MXSP | XXXXX | Maximum allowed system space | 
! CTOP | XXXKX | Task CTOP | 
| UTOP | XXXXX ! Task UTOP | 
! UBOT | XXXXX | Task UBOT ! 
| SLOC ! XXXXKX ! Task starting location | 
! NLU ! XXX Number of logical units 
(decimal) | 
| MPRI ! XXX Maximum priority (decimal) | 
SVOL ! XXXX ! ! 


vam ee enn cee etree ame ene em we cree Nap Om sem em Ne pny ree em mem ra me ee cam ee ame cm cee a nme Erase ae name shin lp 


The addresses displayed as CTOP, UTOP, and UBOT, are not physical 
addresses, but addresses within the task's own program space. 
CLOC may be a program space address or a physical address in a 
system subroutine being executed on behalf of the task. NLU is 
given in decimal. SVOL is the ASCII default volume ID. The 
fields CTOP, UTOP, UBOT, and SLOC are described in detail in the 
OS/32 Application Level Programmer Reference Manual. 


TOPT is given in hexadecimal. The definitions of task option 
bits are listed in Table 2-3. 


TABLE 2-3 TASK OPTION BIT DEFINITIONS 


ssaae tape ae any mat me ame ee AR ae me me HE NR Ec OL Se mms A HP SUG HY nah NR a GM nt 


BIT | MASK MEAN ING 
cee Se Se RE EE SSE RR RE Ce EE Eee eee ae eS | 
4 0800 0000 


0 = Dynamic scheduling disabled 


' 

t 

H H iol Dynamic scheduling enabled f 
{ 1 ! t 
1 | { { 
| 5 { 0400 0000 ; O = Prompt disabled 

{ 1 = Prompt enabled 
! ] { I 
t t | : ‘ 
i; 6 | 0200 0000 ; O = I/O interpreted without VFC H 
{ 1 = All I/O interpreted with VFC 
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TABLE 2-3 TASK, OPTION BIT DEFINITIONS (Continued) 


LO 


16 


17 


18 


19 


20 


21 


22 


23 


24 


25 


26 


27 
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MASK H MEAN ING 


0100 


0080 
0040 
0020 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


0000 


ROL 


eam I a I a a dd 
= = a Se eS SS SS ee a ae ST ST Oe I SUS a ae Se eet 


0000 0 


l = Extended SVC 1 parameter blocks 


i 
H used 
1 
| 
0000 ; O = New TSW for task event service 
i lL = No new TSW for task event service 
0000 ; O = Task event all registers saved 
| Ll = Task event partial registers saved 
{ 
! 
0000 ;} O = Task event no register saved 
i Ll = Task event register saved 
1 
' 
8000 ; O = U-task 
} lL = E-task 
5 
' 
4000 ; O = AFPAUSE 
| L = AFCONT 
{ 
{ 
2000 } O = NOFLOAT 
| Ll = Single floating point 
| 
! 
1000 ; O = NONRESIDENT 
} lL = RESIDENT 
t 
1 
0800 ; O = SVC 6 control call 
} L = Prevent SVC 6 control call 
§ 
t 
0400 ;} O = SVC 6 communication call 
| lL = Prevent SVC 6 communication call 
' 
{ 
0200 | O = SVCPAUSE 
| L = SVCCONT 
4 
t 
0100 ; O = NODFLOAT 
| L = DFLOAT 
' 
t 
0080 }| O = NOROLL 
} L = ROLL 
! 
' 
0040 ; O = No overlay 
| lL = Use overlay 
t 
! 
0020 ; O = Accounting disabled 
| lL = Accounting enabled 
| 
' 
0010 ; O = Task can issue intercept call 
| lL = Task cannot issue intercept call 


= No extended SVC 1 parameter bloc ks 
used (excludes communications I/0) 


tek ea UL ND NRO HH OE ee cm ce ee le ne a ee Pa oe Na LO re ee ee eM em le eo cm Ammen rant iene nn ee itm ate 


TABLE 2-3 TASK OPTION BIT DEFINITIONS (Continued) 


Naas rae a PNR emo EE am a CR em em em mem mr cm eV ec ok LS Sm nm ew rms na Hi NI sg na tei ae 


BIT ; MASK MEAN ING | 
'-28 | 0000 0008 | 0 = No account privileges = S—S=~S 
| 1 = File account privileges | 
! 29 ! 0000 0004 ! O = Bare disk assign not allowed ! 
1 = Bare disk assign allowed | 
! 30 ! 0000 0002 ! 0 Not universal 
1 = Universal 
| 31 | 0000 0001 | 0 = No keychecks ! 
| 1 = Do keychecks | 
STAT is given in hexadecimal. The definitions of wait status 
bits are shown in Table 2-4. 
TABLE 2-4 WAIT STATUS BIT DEFINITIONS 
;BIT | MASK Go MEANING | 
| 15 { 0001 0000 | Intercept wait CS 
| 16 | 0000 8000 | 1/O wait | 
! 17 | 0000 4000 | (Any) IOB/WAIT | 
! 18 ! 0000 2000 ! Console wait (paused) | 
! 19 | 0000 1000 ! Load wait | 
! 20 | 0000 0800 | Dormant ! 
1 21 | 0000 0400 | Trap wait | 
! 22 | 0000 0200 ! Time of day wait | 
1 23 | 0000 0100 ! Suspended ! 
| 24 | 0000 O08D | Interval wait ! 
| 25 | 0000 0040 ! Terminal wait | 
26 0000 60020 ; Roll pending wait 
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TABLE 2-4 WAIT STATUS BIT DEFINITIONS (Continued) 


ee a eR eRe Cs MEO eC ee ce a cr rd 


! ‘BIT i MASK MEANING | 
| 27 | 0000 0010 | Intercept initialization (MT) | 
| 28 ! 0000 0008 | Intercept termination (MTM) | 
| 29 ! 0000 0004 | System resource connection wait | 
! 30 ! 0000 0002 ! Accounting wait ! 


er ne ree Me Me CM ec 


NOTE 


Zero status indicates an active task. 


CTSW is expressed in hexadecimal. For a definition of the status 
portion of the TSW, see the OS/32 Application Level Programmer 
Reference Manual. 

The DISPTLAY PARAMETERS command can be entered in task loaded mode 
and task executing mode. 


Example: 


The following is an example of the output generated in response 
to a DISPLAY PARAMETERS command: 


*DISPLAY PARAMETERS 


TASK MTMUSER 

CTSW 00001000 
CLOC F2B7C 
STAT 2000 
TOPT 10021 
USSP 14F8 
MUSP 2208 
MXSP 3000 
CTOP 24FE 
UTOP 2370 
UBOT 0 
SLOC FOOOO 
NLU L5 
MPRI 128 
SVOL M67A 
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| DISPLAY 
REGISTERS 


2.21 DISPLAY REGISTERS COMMAND 


The DISPLAY REGISTERS command displays to the specified fd the 
contents of the general purpose user registers associated with a 
loaded task. 


Format: 


DISPLAY REGISTERS |, 


Parameter: 
fd is the file descriptor to which the _ contents 
of the general purpose user registers are 
displayed. If fd is omitted, the display is 


output to the user console. 


Functional Details: 


The DISPLAY REGISTERS command can be entered in task loaded mode 
and task executing mode. 
NOTE 


The contents of each register will be 0 
until the task has started. 


000077F0O OOOOE588 

00000000 00000000 00000000 00004801 
OOOO0E83C 00000000 00000000 OOOOD2EA 
OOOOE8CB 00000000 OOO0E848 00000028 
OOO0E804 OOOOESDO OOO0ES584 OOOOEOSE 
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2.22 DISPLAY TIME COMMAND 
The DISPLAY TIME command displays the current date and time to a 
specified fd. 


Format: 


DISPLAY TIME 


Parameter: 


fd specifies the file or device to which the 
display is to be output. If fd is omitted, 
the default is the user console. 


Functional Details: 

The display has the following format: 
mn/dad/yy hh:mm:ss 

or alternatively (by sysgen option): 
dad /mm/yy hh:mm:ss 


The DISPLAY TIME command can be entered in command mode, task 
loaded mode, and task executing mode. 
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2.23 DISPLAY USERS COMMAND 


The DISPLAY USERS command displays the userid, terminal device 
names, and the operating mode of all users currently signed on 
under MTM. Additionally, all active batch jobs are displayed. 


Format: 


DISPLAY USERS 4 


Parameter: 


fd specifies the file or device to which the 
display is output. If fd is omitted, the 
default is the user console. 


Functional Details: 


This command can be entered in command mode, task loaded mode, 
and task executing mode. 


Example: 
DU 
R-NULL: @$HASPOO BG-CT22 : @MTM-MODE NERD-NULL: @$STAT 
LFS-CT26 : >MTM-MODE JON-CT32 : @ECM-MODE VAL-CT2A: )MTM-MODE 
GRAY-CT2C: @MTM-MODE LYNDA-NULL: @$STAT BJIM-CT30 : @MTM-MODE 
DAVE-CT3A: )MTM-MODE BRI-CT3E: )MTM-MODE JOB3-BATCH >MTM-MODE 


>» - denotes nonprivileged MTM user 


@ - denotes privileged MTM user 
MTM-MODE ~- standard MTM usage 
ECM-MODE ~- environmental control monitor mode 


$ - foreground task mode and HASP mode 
BATCH - denotes an active batch job 
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2.24 ENABLE COMMAND 


The ENABLE command allows the prompt or messages previously 
suppressed by the PREVENT command to be displayed on the user 
console. 


Format: 
MESSAGE 
PROMPT 
ENABLE 
k'TM 
SVARIABL.E 
Parameters: 

MESSAGE allows other MTM users to send messages to the 
user terminal. 

PROMPT requests the system to print the hyphen (-) 
prompt in task executing mode. The hyphen (-) 
is the default prompt for task executing mode. 

ETM displays the end of task message. 

$VARIABLE enables variable processing of local and 


global variables on a per user basis. 
Functional Details: 
The ENABLE command does not affect operator messages. 


Local and global variable support is included in the target 
sysgen option SGN.VAR. 


48-043 FOO ROL 2-45 


2.25 EXAMINE COMMAND 
The EXAMINE command examines the contents of a memory location in 
the loaded task. 


Format: 


n 


EXAMINE address; /address2 , 


Parameters: 


address indicates the starting and ending addresses in 
memory whose contents are to be displayed in 
hexadecimal. All addresses specified are 
rounded down to halfword boundaries by the 
system. 

n is a decimal number specifying the number of 


halfwords to be displayed. If n is omitted, 
one halfword is displayed. 


fd is the file descriptor specifying the file or 
device to which the contents of memory are 
displayed. If omitted, the default is the 
user console. 


Functional Details: 


Specifying only address, causes the contents of memory at that 
location (as modified by any previous BIAS command) to be 
displayed. Specifying address; and address2 causes all data from 
the first to the second address to be displayed. 


The EXAMINE command can be entered in task loaded mode and task 
executing mode. 


Any memory that can be accessed by the loaded task can be 
examined with the EXAMINE command. For example, if a task uses 
a PURE segment that is mapped to segment register F, then 

examining addresses at FOOOO or greater will display the contents 
of the PURE segment. 
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Example: 


BI B100 Examines 10 halfwords starting at 
EXA 100,10 relative address 100 (absolute 
address B200) within the task. 
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2.26 FFILE COMMAND 


The FFILE command forward spaces to the next filemark on magnetic 


tapes, cassettes, 
Format: 

FFILE [fd,] lu 
Parameters: 


fd 


lu 


and direct access 


files. 


is the file descriptor of the device or file, 
to be forward spaced one filemark. 
is the lu to which the file is assigned. If 


lu is specified without fd, the operation is 
performed on the lu regardless of what is 
assigned to it. 

Functional Details: 

The FFILE command can be entered in task loaded mode. 

Examples: 

FF 1 Causes the file or device assigned 
to lul to forward space one 
filemark. 

FF M300:AJM.OBJ,4 Causes the file AJM.OBJ on volume 
M300 that is assigned to 1u4, to 


forward space one filemark. 
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2.27 FRECORD COMMAND 

The FRECORD command forward spaces one record on magnetic tapes, 
cassettes, and direct access files. 

Format: 


FRECORD [fd,] lu 


Parameters: 


fd is the file descriptor of the device or file 
to be forward spaced one record. 

Lu is the lu to which the device or file is 
assigned. If lu is specified without fd, the 


operation is performed on the lu regardless of 
what is assigned to it. 


Functional Details: 


The FRECORD command can be entered in task loaded mode. 


Examples: 
FR 1 Causes the device or file assigned 
to lul to forward space one record. 
FR M300:AJM.OBJ,4 Causes’ file M300:AJM.OBJ on volume 


M300 that is assigned to lu 4 to 
forward space one record. 
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2.28 HELP COMMAND 
The HELP command displays information on MTM user and _ program 
development commands. 


Format: 


mnemonic 
HELP 


x 


Parameters: 
mnemonic is any valid MTM or _ program development 
command mnemonic. 
* causes a list of all MTM and program 


development commands to be displayed to the 
List device. 


Functional Details: 


The HELP command is implemented as a CSS _ procedure. When a 
mnemonic or command is entered, information on how to use that 
particular command is displayed to the list device. If 
parameters are omitted, information on how to use the HELP 


command is displayed to the list device. 


Examples: 


HELP LOG Displays to the List device 
information on how to use the MTM 
LOG command. 


HELP COMPILE Displays to the list device 
information on how to use the 
program deve lopment command, 
COMPILE. 

HELP Displays to the list device 
information on how to use the HELP 
commana. 
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Example: 


HELP * 

ADD AL (TLOCATE ) AS (SIGN) BF (TLE) 
BI(AS) BREA(K) BR(ECORD) BU( ILD) 
CAL CA(NCEL) CL (OSE) COBOL 
COMMAND COMP [TE COMPL INK CO(NTINUE) 
DE (LETE ) D( ISPLAY ) EDIT ENA ( BILE) 
ENDB ENV EXA(MINE) EXEC 

FF (I.E) F [LEDESC FORT FORTO 
FORTZ FR(ECORD) HELP INIT 

LINK LIST L( OAD) LOG 

MACRO ME (SSAGE ) MO(DIFY) O(PTION) 
PASCAL PAS (SWORD ) P (AUSE) PRE (VENT ) 
PRI (NT) PUN (CH) REL (EASE ) REMOVE 
REN (AME ) REP (ROTECT) REW( IND) RPG 

RUN RW RVOL (UME ) SEN(D) 
SE(T) SIGNOF (F ) S( IGNON) SPOOLF ITE 
ST (ART) T(ASK) © TE (MPF ILE) V (OL.UME ) 
WF ( IT.E) XAL (LOCATE ) XDE (LETE ) SUB (MIT) 
INQ (UIRE) PUR(GE) 

For HELP on any of the command mnemonics, type  HEI.P 
«command > 

Example: 


HELP PASSWORD 


PASSWORD: 


The PASSWORD command enables any user who has the 


PASSWORD privilege to alter his own signon password. 
FORMAT : 
(PAS)SWORD CURRENT PASSWORD, NEW PASSWORD 


PARAMETERS : 


CURRENT PASSWORD must exactly match the user's current 


account password. 
NEW PASSWORD specifies the new account password. 
This password replaces’ the current 
password in the authorized user file. 
The password can _ be up to 12 
characters long; remaining characters 
are truncated. All alphabetic, 
numeric, and special characters 
except blanks, commas, or semicolons 
are allowed. 
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2.29 INIT COMMAND 


The INIT (file initialization) command initializes all data on a 


contiguous file to 0. 


Format: 


segsize increment 
INIT fd |, 


Parameters: 


is the file descriptor of any unassigned, 


fa 
unprotected, contiguous file. 

segsize is the size of the buffer space used. The 

increment default is lkb. 


Functional Details: 


INIT is implemented with a CSS procedure that loads and starts 


the File Manager Support Utility as a task. 


The INIT command can be entered in command mode. 


Examples: 


INIT DATA.FIL Initializes the file DATA.FIL. 


Initializes the file DATA2.FIL using 


INIT DATA2.FIL,50 
a 50kb buffer. 
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2.30 LOAD COMMAND 


The T.0AD command is used to load a user's task into memory. 
Format: 

LOAD [taskid;] fa[,segsize increment ] [SCTASK] 
Parameters: 

taskid | specifies the name of the task to be loaded. 


fd specifies the file or device the task is being 
loaded from. 


segsize specifies amount of memory in kb (above the 
increment memory size) that the task needs for 
processing. When a task is built (via Link), 


the OPTION WORK=n command adds additional 
memory to atask. The size field in the LOAD 
command overrides’ the amount of memory 
specified by Link. The size is accepted in 
-25kb increments. 


SCTASK specifies that the task is to be loaded as an 
SPL/32 spooler subcontrol task. See the 
SPL/32 Administration and Reference Manual for 
information on subcontrol tasks and their 
function. If the SPL/32 spooler is not the 
spooler being used on the system, the 
attempted use of this parameter will generate 
an error message. 


Functional Details: 


In order to maintain CSS compatibility, the taskid (.BG) can be 
used. However, the system will ignore it. Any valid taskid can 
be entered but will be ignored. 
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If a task is loaded from a direct access device, the system first 
searches the user volume or the specified volume under the user's 
account. If the file is not found in the search, the system will 
search the SYS volume in the SYS account if an account or a 
volume designator was not specified in the LOAD command. Only 
values that the user does not explicitly specify will 
subsequently be searched for. If an extension is not specified 
in the LOAD command, the extension .TSK is assumed. The LOAD 
command can be entered in command mode. 


An error might occur if a user ID under MTM is the same as the ID 
of a task loaded from the system console. If a load or fd error 
is displayed, sign off and sign on again with a different user 
ID. 


A privileged user can specify an account number in the fd. All 
other users can only specify an account class designator (P, G, 
S). 


Examples: 
L VOL: CAL Load the task from file VOL:CAL.TSK. 
L PTRP: Load a task from the paper tape 


reader punch device. 


2-54 . 48-043 FOO RO1 


2.31 LOG COMMAND 


The 1.0G command logs all user input and MTM responses to a 


specified fd. 


Formats: 


Parameters: 


fd 


COPY 


NOCOPY 
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is the file descriptor of the log file or 
device. If no fd is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
privileges so that logged output is added to 
the end of the file. If a log is active when 
another LOG command is entered, the old log is 
closed and the new one is initiated. 


specifies that all output is written to both 


the terminal and the log device. 


specifies that all output (except messages) is 
written to the log device and not to the 
terminal. Messages from other users and the 
operator are written to both the terminal and 
the log device. If this parameter is omitted, 
COPY is the default. 


is a decimal number from 0O through 65,535 
specifying the number of lines after which the 
user log file is to be checkpointed. If this 
parameter is omitted, the default is 15 lines. 
If n is specified as 0, no checkpointing will 
occur. 


Functional Details: 


The LOG command and the SET LOG command are the _ same. The 
command can be entered either way, and both formats perform the 
same function. 


Checkpointing may be done on any type of file. Since indexed 
files are buffered, checkpointing may be useful at any time the 
file is being written to. Checkpointing nonbuffered indexed 
files and extendable contiguous files is useful only if the file 
is being expanded. Checkpointing to a contiguous file is 
meaningless (no operation is performed). The LOG command can be 
entered in command mode, task loaded mode, and task executing 
mode. 


Example: 


LOG LOG.FIL, COPY, 10 
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2.32 MESSAGE COMMAND 


The MESSAGE command 
Format: 


userid 
MESSAGE 


Parameters: 
userid 
message 


Functional Details: 


The user receiving 


»QPERATOR 


sends a message to a specified user. 


message 


is the name of the user the message is being 
sent to. This id can be obtained from the 
DISPLAY USERS command. A userid of .OPERATOR 
sends a message to the system console. 


is the text of the message that the user wants 
to send. 


the message receives the userid of the’ sender 


as well as the message. 


This command can be entered in command mode, task loaded mode, 


and task executing 


Example: 


mode. 


The following message is sent to userid "AVE" from userid "TK". 
The format of the message sent is: 


ME AVE HEI.LO MTM USER 


The format of the message received is: 


TK-HELLO MTM USER 
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2.33 MODIFY COMMAND 


The MODIFY command modifies the contents of a memory location in 
the loaded task. 


Format: 
data, 
MODIFY address, [,dataz,...,datan| 
Parameters: 
address is the halfword boundary address at which the 
contents of memory are to be modified. 
data is a data field consisting of zero to four 


hexadecimal digits that represent a halfword 
to be written into memory starting at. the 
location specified by address. Any string of 
data less than four characters is 
right-justified and left-zero filled. If the 
comma is entered but data is omitted, 0O is 
entered into one halfword. 


Functional Details: 


This command causes the contents of the halfword location 
specified by address (modified by any previous BIAS command) to 
be replaced with data. The modify address must be aligned on a 
halfword boundary. 


The MODIFY command can be entered in task loaded mode and task 
executing mode. 


Any segment (impure, shared, or task common) to which a_ u-task 


has write access can be modified. Only the impure segment can be 
modified for an e-task. 
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Examples: 


BIAS O 
MOD 12F0,4,0,4,0 


MOD DOOO00,4 
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Modifies four halfwords at location 


12FO to contain 0004 O0000 0004 
0000. 


Modifies the first halfword of the 
task common linked to the task using 
segment register D to 4. 


2.34 OPTIONS COMMAND 


The OPTIONS command 


allows an MTM user to change the task options 


of the currently loaded task. 


Format: 
OPTIONS 


Parameters: 
AF PAUSE 


AF CONTINUE 


SVCPAUSE 
SVCCONT INUE 


NONRES IDENT 


Functional Details: 


AFPAUSE SVCPAUSE 
AFCONT [NUE ; 


[; NONRES IDENT] 
SVCCONT INUE 


specifies that the task is to pause after any 
arithmetic fault. 


specifies that if the arithmetic fault (AF) 
trap enable bit is set, a trap is taken. If 
the bit is not set, the task continues) after 
an arithmetic fault occurs, and a message is 
sent to the log device. 


specifies that SVC 6 is treated as an illegal 
SVC (applies to background tasks only). If an 
SVC 6 is executed within a background task, 
the task is paused. 


specifies that SVC 6 is treated as a NO-OP 
(applies to background tasks only). If an SVC 
6 is executed within a background task, the 
task is continued. 


specifies that the task is to be removed from 
memory at end of task. 


The OPTIONS command can be entered in task loaded mode. 


Example: 


OPT AFC,SVCC 
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2.35 PASSWORD COMMAND 


The PASSWORD command e 
privilege (privileged 


Format: 


PASSWORD current p 


Parameters: 


current password 


new password 


Functional Details: 


If a user without the 
command, a MNEM-ERR me 
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PASSWORD 


nables any MTM users with the PASSWORD 
user) to alter their own signon passwords. 


assword, new password 


must exactly match the user's current 
account password. 


specifies the new account password. This 
password replaces the current password in 
the authorized user file. The password can 
be up to 12 characters long; remaining 
characters are truncated. All alphabetic, 
numeric, and special characters except 
blanks, commas, or semicolons are allowed. 


PASSWORD privilege enters the PASSWORD 
ssage is generated. 


2.36 PAUSE COMMAND 


The PAUSE command pauses the currently running task. 


Format: 


PAUSE 


Functional Details: 


Any I/O proceed, ongoing at the time the task is paused, is 
allowed to go to completion. This command is rejected if the 
task is dormant or paused at the time it is entered. 


The PAUSE command can be entered in task loaded mode and task 
executing mode. 


N 
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2.37 PREVENT COMMAND 


The PREVENT command suppresses either messages or the task 
executing prompt (the hyphen (-) is the default) while an 
interactive task is running. 


Format: 
MESSAGE 
PROMPT 
PREVENT 
E‘TIM 
SVARIABI.E 


If a user did not input any of these parameters the terminal will 
receive both messages and task executing prompts. The task 
executing prompt indicates that either a task or CSS is 
executing. 


Parameters: 

MESSAGE prevents other MTM users from being able to 
send messages to the user terminal. 

PROMPT suppresses the printing of the task executing 

_ prompt (the hyphen (-) is the default) during 

task executing mode. 

ETM supresses the display of end of task message. 

$VARIABLE disables variable processing on a per user 


basis. 


Functional Details: 


If the MTM system includes variable support and the $VARIABLE 
parameter is entered, the overall performance of MTM increases. 
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2.38 PRINT COMMAND 


The PRINT command sends the file to be printed to the Spooler for 
subsequent printing. 


Format: 


PRINT fd [,DEVICE=pseudo device] [,COPIES=n] [,DELETE] [,VFC] 


Parameters: 


fd 


DEVICE= 


COP IES= 


DELETE 


VFC 


Functional Details: 


is the name of the file to be printed. 


pseudo device specifies the print device. If 
this parameter is omitted, output is directed 
to any available print device. 


n allows the user to specify the number of 
copies of the file fd to be output. From 1 to 
255 copies can be made. If this argument is 
omitted, one copy is the default. 


specifies the file fd is to be deleted after 
the output operation is completed. If this 
argument is omitted and the file is not a 
spool file, the file is retained. 


specifies that vertical forms control is in 
use. Currently, the card punch driver does 
not support VFC. 


i If the spool option was not selected at OS/32 sysgen time, this 
command results in an error. 
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The PRINT command can be entered in command mode, 
mode, and task executing mode. 


NOTE 


If the SPL/32 spooler is in use on the 
system, the MTM user has additional 
options available for use with the PRINT 
command. See the SPL/32 Administration 
and Reference Manual for a detailed 
description of these additional options. 
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task 


Loaded 


2.39 PUNCH COMMAND 


The PUNCH command indicates to the Spooler that the specified 
file is to be punched. 


Format: 
PUNCH fd [,DEVI 
Parameters: 


fda 


DEVICE= 


COPIES= 


DELETE 


VFC 


Functional Details: 


CE=pseudo device] [,COPIES=n] [,DELETE] [,VFC] 


is the name of the file to be punched. 


pseudo device specifies the name of the pseudo 
output device. If the DEVICE= parameter is 
omitted, punch output is directed to any 
available punch device. 


n is the number of copies desired. From 1_ to 
255 copies can be made. If the 
COPIES= parameter is omitted, only one copy 
is output. 


specifies that the fd is to be deleted after 
the output operation is performed. If 
omitted, the file is retained. 


specifies that vertical forms control is in 
use. Currently, the card punch driver does 
not support VFC. 


i If the spool option was not selected at OS/32 sysgen time, this 


command will result 


in an error. 
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The PUNCH command can be entered in command mode, 
mode, and task executing mode. 


NOTE 


If the SPL/32 spooler is in use on the 
system, the MTM user has additional 
options available for use with the PUNCH 
command. See the SPL/32 Administration 
and Reference Manual for a detailed 
descripion of these additional options. 
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Loaded 
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2.40 RELEASE COMMAND 


The $REIEASE command is used to release a new global or new 


internal variable. 


It also releases the variable's associated 


buffer. This command has no effect on local or global variables 
created with the $SET command. 


Format: 


SRELEASE 


Parameters: 
GVARIABL.E 


[VARIABI.E 


n;,/Nz 
Ngo. Np, 


ALJ 


Functional Details: 


ny /Nno2 


GVARIABLE 


sean ae L —_ re] 


indicates that the variables to be released 
are new global variables. 


indicates that the variables to be released 
are new internal variables. 


specifies that all variables (of the type 
selected via the preceding parameter) between 
the range of n,/n2g be released. Where nis a 
decimal number between 1 and the value allowed 
at MTM sysgen for the selected variable type. 


n is a decimal number of a variable (either 
new global or new internal) or variables to be 
released. n must be within the range of 1 and 
the maximum value allowed at MIM sysgen for 
the selected variable type. 


specifies that all new internal or new global 
variables be released. This is the default if 
no specific variable numbers are specified. 


This command may be entered in command mode, task loaded mode, 
task executing mode, and CSS mode. 
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In order to reduce buffer overhead, 
used should be released. 


being 


variables that are no longer 
If this command is directed to a 


variable that was already released, the command is ignored and no 


error message is generated. 


New internal variables 
automatically released. 


Examples: 


$RELEASE GVARIABI.E,1/5 


that have a 


$RELEASE IVARIABIE,16,19,18,25 


RELEASE [VARIABLE, ALL 


This 


global variables created with the 


command. 
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null or zero value are 
All new global variables from 1 
through 5 are released. 
The new internal variables numbered 
16, 19, 18, and 25 are released. 
All new internal variables are 
released. 
NOTE 
command does not release local and 
$SET 
2-69 


2.41 RENAME COMMAND 


The RENAME command changes the name of an unassigned, direct 
access file. 


Format: 


RENAME oldfd,newfad 


Parameters: 
oldfd is the current file descriptor of the file to 
be renamed. 


newfd is the file descriptor of the renamed file. 


Functional Details: 


The volume id field of the new file descriptor (newfd) may be 
omitted. A file can only be renamed if its write and read 
protection keys are O (X'0000'). 


The RENAME command can be entered in command mode, task loaded 
mode, and task executing mode. 


The user can only rename private files. 


Example: 


REN VOL:AJM.CUR,AJM.NEW Renames file AJM.CUR to AJM.NEW on 
volume VOL. 


2-70 48-043 FOO RO1 


2.42 REPROTECT COMMAND 


The REPROTECT command modifies the protection keys of an 
unassigned, direct access file. 


Format: 


REPROTECT fd,new keys 


Parameters: 


fda 


new keys 


Functional Details: 


is the file descriptor of the file to be 
reprotected. 


is a hexadecimal halfword whose left byte 
signifies the new write keys and whose right 
byte signifies the new read keys. 


Unconditionally protected files can be conditionally reprotected 


or unprotected. 


The REPROTECT command can be entered in command mode, task loaded 
mode, and task executing mode. 


The user can only REPROTECT private files. 
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2.43 REWIND AND RW COMMANDS 


The REWIND and RW commands rewind magnetic tapes, cassettes, and 
direct access files. 


Format: 


REWIND [fd,] 1u 
or 


RW [fd,] lu 


Parameters: 


fda is the file descriptor of the device or file 
to be rewound. 

lu is the logical unit to which the device or 
file is assigned. If lu is specified without 


fd, the operation is performed on the lu 
regardless of what is assigned to it. 


Functional Details: 


The REWIND and RW commands can be entered in task loaded mode. 


Examples: 
REW 1 Causes the file or device assigned 
to lul to be rewound. 
REW M300:AJM.OBJ,4 Causes file AJM.OBJ, as assigned to 


lu4 on volume M300, to be rewound. 
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2.44 RVOLUME COMMAND 


The RVOLUME command enables an MTM user to allow/disallow access 
to a privately owned disk. 


Format: 


actno, ,...,max actno 
RVOLUME voln, 
REMOVE, 


actno 


USERS |,<actno;, - actnoo2 


Parameters: 


voln is the volume name of the restricted disk. 

ADD indicates that the specified accounts’ will 
have access to the restricted disk. 

actno is a decimal number from 0 through the maximum 
account number allowed on the system (Limit 
65,535) indicating the accounts 


allowed/disallowed access to the restricted 
disk. If ALL is specified, accounts O through 
the maximum account number allowed on the 
system (limit 65,635) have access to the 
restricted disk. 
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RW indicates that the specified account has 


read/write access to the restricted disk. If 
this argument is omitted, the default is read 
only. 

RO indicates that the specified account has'~ read 


only access to the restricted disk. 


REMOVE indicates that the specified accounts) are 
disallowed access to the restricted disk. If 
ALL is specified, all accounts having access 
to the restricted disk are disallowed access 
with the exception of the owner's account. 


USERS displays all accounts having access to the 
restricted disk along with the access 
privileges. 


Functional Details: 


A disk marked on as a system disk is treated as a restricted 
disk. Account number 255 is the owner. 


The owner of a private disk can allow/disallow other MTM users, 
the system operator, and other non-MTM tasks access to the 
restricted disk. 


If an owner enters a REMOVE parameter specifying a private 
account, access will be denied to the disk; the owner can still 
add accounts, remove accounts, and display accounts that have 
access, along with the respective access privileges. 


For a user with RW access to a restricted disk, accessing 
private, group, and system files is exactly the same as accessing 
files on any other disk. 


For a user with RO access to a restricted disk, accessing group 
and system accounts is the same as accessing files on any other 
Gdisk. Files within the user's’ private account can only be 
assigned SRO or ERO. The user cannot allocate, rename, 
reprotect, or delete any files. 
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Examples: 


ry 

RVOL M'I'M,U 
OO0O000/RW 00001-00017/RO0 OOOL8/RW 00019-00254/R0 
00255/RW 00256-01023/RO0 


RVOL MTM,A,87/RW 

RVOL MTM,U 
OONO00G/RW 00001-00017/R0 O0018/RW 00019-00086/R0 
Q00087/RW 00088-00254/R0 00255/RW 00256-01023/R0 


RVOL MI'M,U,87 
00087/RW 


RVOL MIM,R,87 

RVOL MTM,U 
00000/RW 00001-00017/R0 00018/RW 00019-00086/RO 
00088-00254/RO0 00255/RW 00256-01023/R0 


RVOL MTM,A,87 

RVOL MTM,U 
QO000/RW 00001-00017/RO OOO1L8/RW 00019-00254/RO0 
00255/RW 00256-01023/RW 


RVOL MTM,U,87-1200 error since account 

ACCT-ERR POS=87-1200 Limit was 1023 

RVOL, MTM,U,87-1000 

00087-00254/RO 00255/RW 00256-01000/RO0 
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2.45 SEND COMMAND 


The SEND command sends a message to the currently selected task. 
Format: 

SEND message [#] 
Parameters: 

message is a l- to 64-character alphanumeric string. 
Functional Details: 


The message is passed to the selected task the same way as an SVC 
6 send message. Following standard SVC 6 procedures, the message 
consists of an 8-byte taskid identifying MTM as _ the_ sender, 
followed by the user-supplied character string. The message 
passed to the selected task begins with the first nonblank 
character following SEND and ends with a carriage return (CR) or 
semicolon (;) as a line terminator. A message cannot be sent to 
a task currently rolled out. 


The receiving task must have intertask message traps enabled in 
its TSW and must have an established message buffer area. Refer 
to the OS/32 Supervisor Call (SVC) Reference Manual for more 
information on SVC 6. 


The SEND command can be entered in task executing mode. 
Example: 
SEND CLOSE LU2,ASSIGN LU3 


The following is received by the task: 


-MTM CLOSE LU2, ASSIGN LU3 


No 
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2.46 SET GROUP COMMAND 


The SET GROUP command enables a privileged user to change the 
group account number associated with the account the user is 
currently on. This enables a privileged user to specify any 
account in the system as the current group account. This command 
is only valid when issued by a privileged user. 


Format: 
SET GROUP n 
Parameters: 


n is a decimal number specifying the new group 
account to be associated with the user's 
current account. This number must be within 
the range of O and the maximum account number 
set in AUF (cannot exceed 65,535). 


Functional Details: 


The SET GROUP command can be entered in command mode, task loacted 
mode, task executing mode, or from a CSS. If a task is loaded or 
executing, MT also modifies the group account number in the task 
control block (TCB). 


If a nonprivilegeda user enters this command the following message 
is generated: 


MNEM-ERR POS=GROUP 


A user may not set his group account to 255. 
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Example: 


The user signs on to account 205 (with privilege option). The 
group account number associated with account 205 is 240. A 
DISPLAY FILES command of the following format will cause’ the 
files in account 240 (account 205's group account) to be 
displayed: 


DF -.-/G 


A privileged user can then change the group account with the SET 
GROUP command: 


SET GROUP 220 


Now the same DISPLAY FILES command will cause the files’ in 
account 220 (account 205's new group account) to be displayed. 


The new group account association only exists for the length of 
the current signon session. The group-private account 
associations specified with the authorized user utility are not 
changed by this command. The privileged user may change group 
numbers as many consecutive times as is desired. 
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2.47 SET KEYOPERATOR COMMAND 
The SET KEYOPERATOR command is used to change the operator 
character used when defining keywords in a CSS call. When 


entered without parameters, this command will display the current 
operator character. 


Format: 


SET KEYOPERATOR [character] 


Parameters: 

character is any one of the following characters which 
will be used for defining keywords in CSS 

calls: 

> 

$ 

& 

# 


If no character is entered, the current 
_ Keyword operator is displayed. 


Functional Details: 


At signon, the default keyword operator is the equal (=) sign. 
When this operator is changed via the SET KEYOPERATOR command, 
the new operator remains in effect until signoff or until another 
SET KEYOPERATOR command is entered. 
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NOTE 


The SET KEYOPERATOR command only changes 
the operator used when defining keywords 
in a CSS call. It has no effect on the 
operator used when referencing keywords 
within a CSS. 


If the character designated as the keyword operator is to be 
passed as part of a character string in a CSS call, it must be 
placed within single or double quotes. 
If the keyword operator is used in a CSS call and is not within 
quotes (single or double), and is not a valid keyword assignment, 
the following error message is generated. 

KEYW-ERR POS= 

(x) MUST BE WITHIN 'OR" IF NOT USED AS A KEYWORD OPERATOR. 


The SET KEYOPERATOR command can be entered in CSS mode, task 
loaded, task executing, and command mode. 
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SET PRIVATE | 


2.48 SET PRIVATE COMMAND 


The SET PRIVATE command enables a privileged user to change the 
private account that the user is currently in without knowing the 
password of the new account. This enables a privileged user to 
access any account on the system as their private account. This 
command is only valid when issued by a privileged user. 


Format: 
SET PRIVATE n 
Parameter: 


n is a decimal number specifying the new private 
account number the user wants access to, 
except account 255. Account 255 can only be 
accessed via SIGNON. n is within the range of 
0 to the maximum account number set in the 
authorized user file (cannot exceed 65,535). 


Functional Details: ' 


The privileges of the user's original signon account’ remain in 
effect regardless of the account the user is currently in. A 
user can neither gain nor lose privileges when moving from 
account to account. 


The SET PRIVATE command can be entered in command mode, task 
loaded mode, task executing mode, and from a CSS. If a task is 
loaded or executing when a SET PRIVATE command is entered, MTM 
also modifies the private account number in the TCB. 

If a nonprivileged user enters this command, the following 
message is generated: 


MNEM-ERR 
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Example: 


The user is signed on to account number 255. A DISPLAY FILES/P 
command would display all files in account 255. The user changes 
the current account with a SET PRIVATE command: 


SET PRIVATE 210 


The current account number becomes 210. The group account number 
remains unchanged. A DISPLAY FILES/P command would display all 
files in account 210. The user may alter private accounts as 
often (consecutively) as is desired. Note that account times and 
usage information used by the accounting reporting utility use 
the original signon account number regardless of the account the 
user is in at signoff time. 
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SIGNOFF 


2.49 SIGNOFF COMMAND 
The SIGNOFF command terminates the terminal session. If a user 
signs off when a task is loaded, the task is cancelled. 
Format: 
SIGNOFF 


Functional Details: 


When a terminal user signs off the system, these messages are 
displayed: 


ELAPSED TIME=hh:mm:ss CPUTIME=ut ime/ost ime 
SIGNON LEFT=hh:mm:ss CPU LEFT=nh:mm:ss 
TIME OFF=mm/dd/yy hh:mm:ss 


The SIGNOFF command can be entered in command mode, task loaded 
mode, and task executing mode. It cannot be followed by another 
command on the same command line. 
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2.50 SIGNON COMMAND 


The SIGNON command allows a user to communicate with MTM. No 
commands are accepted until a valid SIGNON command is entered. 


Format: 


fd 


SIGNON userid,actno,password | ,ENVIRONMENT= 


[ CRUTIME=maxt ime | 


NULL [=] 


: classid=iocount} [ ...,Cclassid= iocountsa] | 


Parameters: 


userid 


actno 


password 


ENV I RONMENT = 


is a l- to 8-character alphanumeric string 
specifying the terminal user's identification. 


is a l- to 5-digit decimal number specifying 
a valid account number (defined in the AUF). 
If the number is greater than the current 
account limit (set in the AUF) or is not an 
established account, an error message is 
generated. . 


is a l- to 1l12-character alphanumeric string 
specifying the terminal user's password. 


fd is the file descriptor specifying an 
existing file that will establish the user's 
environment at signon time. 


NULL specifies that the signon CSS routine, 
USERINIT.CSS, should be ignored and the user 
will establish the environment after signing 
on. 


If the entire keyword parameter is omitted, 
MTM searches all online disks for the signon 
CSS procedure USERINIT.CSS/P. The system 
account, on the system volume, is searched 
last. If USERINIT.CSS is found, MIM calls the 
CSS and executes the routine. If it is not 
found, MTM enters command mode. 
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If the user does not have the ENV= privilege 
(privilege to enter ENV- at signon), MTM will 
ignore this parameter and force the 
USERINIT.CSS to be executed (if found). 


CPUTIME- maxtime is a decimal number specifying the 
maximum CPU time to which the session is 
Limited. if this parameter is omitted, the 


default established at sysgen time is used. 
If 0 is specified, no limits are applied. The 
parameter can be specified as: 


mmmmn: ss 
hhhh:mm:ss 
ssss 


classid= is one of the 4-character alphanumeric 
mnemonics specified at sysgen time associated 
with each specified device or file class. 

Locount is a decimal number specifying the maximum 
number of I/0 transfers associated with a 
particular device class to which the job is 
Limited. If this parameter is omitted, the 
default established at sysgen time is used. 


If O is specified, no limits are applied to 
that class. 


Functional Details: 
The SIGNON command can be entered in command mode. It cannot’ be 


followed by another command on the same line. 


When ENVIRONMENT=NULL is specified, the colon is optional. This 
allows the user the ability to specify the null device (NULL:). 


The ENVIRONMENT= parameter may be ignored by’ the system, 
depending on the user's account privileges. 


Examples: 


SIGNON ME,12,PASSWD 
SIGNON ME, 118,SWDOC, ENV=NUL.L 


SIGNON ME, 118,SWDOC, ENV=XYZ 
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2.51 SPOOLFILE COMMAND 


This command is valid only on systems which are using the SPL/32 
spooler. Systems on which the 0S/32 spooler is being used may 
not use the spoolfile command. 


The SPOOLFILE command aliows a user to allocate a spool file on 
behalf of a specified pseudo device and assign that file toa 
specified lu of the currently selected task. This command makes 
all spooling options available at a terminal or command 
substitution system (CSS) level. 


Format: 


VFC 
SPOOLFILE lu&lul,pseud dev, FORM=formname 4 


ee scsmams 


,BLOCK= blocksize/indexsize , 


; [; COPLES=n] 4 


HOLD 


; [. PRIORITY=p] 
NODELETE 


Parameters: 


Lu is a decimal number specifying the logical 
unit to which the pseudo device is to be 
assigned. 

lul indicates that lu is to be assigned to the 
same spool file as lul. 1lul must be the first 


lu assigned to the spool file. 


pseud dev is the 1- to 4-character name of a _ pseudo 
device. The first character must be 
alphabetic; the remaining alphanumeric. 


FORM= is a desired preprinted form name that can _ be 
specified here. If the form specified was not 
previously enabled using a FORM command, an 
error message is sent to the monitor ing 
control or subcontrol task and the request is 
processed using the default standard form 
name, STD. 
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VFC 


NOVFC 


COPTIES= 


HOT.D 


RELEASE 


BLOCK 


blocksize 


indexsize 


DELETE 


NODELETE 


PRIORITY=p 
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specifies the use of vertical forms’ control 
for the assigned lu. When VFC is used, the 
first character of each record is’ interpreted 
aS a vertical forms control character. If VFC 
is not included, there is no vertical forms 
control for the device assigned to the 
specified lu. 


turns the vertical forms control option off 
for the assigned lu. This is the default 
option. 


identifies the number of copies to be output. 
It must be between 1 and 255 or an error 
message is sent. 


causes the specified file to remain on the 
spool queue until a RELEASE request is issued. 


enables a spool file for output when the lu is 
closed. 


specifies the index and/or data block size. 


is a decimal number specifying the physical 
block size in 256-byte sectors, to be used for 
buffering and debuffering operations involving 
the file. The default size is 1 or the value 
entered using the BLOCK command. If this 
value exceeds the max imum block size 
established at sysgen time, an error will be 
printed when attempting to allocate the file. 


is a decimal number specifying the index block 
size in 256-byte sectors. The default size is 
1 or the value entered using the BLOCK 
command. Index size cannot exceed the maximum 


index block size established at sysgen time or 


an error will occur when attempting to 
allocate the file. 


the file is deleted after output. This is the 
default option. 


the file is not deleted after output. 


p is the desired print priority. If this 
option is not specified, the print priority 
becomes the same as the priority of the task 
from which the spool file assign originated. 


Functional Details: 


The SPOOLFILE command can be used to make an assignment to a 
pseudo device from the terminal or CSS level. If two conflicting 
parameters are entered in a single SPOOLFIILE command, such as 
DELETE and NODELETE, the second parameter is executed and an 
error message is generated. The SPOOLFILE command can be entered 
in task loaded mode. 


Example: 


SPOOLFILE 4,pdl1:,VFC,DELETE 


This éxample causes a spool file to be allocated for pseudo 
device pdl: and assigns that file to logical unit 4 of the 
current task. Vertical forms control has been specified for the 
specified lu and the DELETE option has been selected, which means 
the file will be deleted after output. 
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2.52 START COMMAND 


The START command i 


Format: 


ada 


START 


nitiates execution of a dormant task. 


ress 
[-parameter, ,...,parametern | 


Parameters: 


address 


parameter 


Functional Details: 


The START command c 


specifies the address at which task execution 
is to begin. For user tasks, this is not a 
physical address but an address within the 
task's own program. For executive tasks, it 
is a physical address. If address is omitted 
or is 0, the loaded task is started at the 
transfer address specified when the task was 
established. 


specifies optional parameters to be passed to 
the task for its own decoding and processing. 
All user specified parameters are moved to 
memory beginning at UTOP. If no parameters 
are specified, a carriage return is stored at 
UTOP. 


an be entered in task loaded mode. 


Examples: 
ST 138 Starts the currently selected task 
at X'138'. 
ST 100,NOSEG,SCRAT Starts the currently selected task 


ST ,1000,ABC 
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at X'100' and passes NOSEG,SCRAT to 
the task. 


Starts the currently selected task 
at transfer address and passes 
1000,ABC to the task. 
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2.53 TASK COMMAND 


The TASK command maintains CSS compatibility of MIM to the 


operating system. No specific action is performed by this 
command. 
Format: 
taskid 
TASK 
.BGROUND 

Parameters: 

taskid is the name of the taskid that has been loaded 


into the foreground segment of memory. 
- BGROUND indicates that the task has been loaded as a 
background task. 


Examples: 


T .BG 


T COPY 
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2.54 TEMPFILE COMMAND 


The ‘‘EMPFILE command allocates and assigns a temporary file to an 


lu for the currently selected task. 


for the duration of the assignment. When a temporary file is 
closed, it is deleted. 


Format: 


TEMPFILE lu, 


Parameters: 


Lu 


CONT IGUOUS 


fsize 


BC 
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CONTIGUOUS, fsize 


bsize 
eee ees ‘isize » 
INDEX |, 4 : d | | 


is a decimal number specifying the lu number 
to which a temporary file is to be assigned. 


specifies that the file type to be allocated 


is contiguous. 


is a decimal number specifying the total 
allocation size in 256-byte sectors. This 
size can be any value up to the number of 
contiguous free sectors existing on the 
specified volume at the time the command is 
entered. 


specifies that the file type to be allocated 
is extendable contiguous. 


A temporary file exists only 


bs ize is a decimal number specifying the _ physical 
block size to be used for buffering and 
debuffering operations. bsize represents’ the 
block size in sectors of the physical data 
blocks containing the file. For INDEX files, 
this parameter cannot exceed the maximum block 
size established by the system generation 
(sysgen) procedure. For EC and NB files, this 
parameter mav be any value between 1 and 255 


inclusive. If bsize is omitted, the default 
value for iNVDEX files is 256 bytes (one 
sector). For EC and NB files, the default is 


64 sectors. 


isize is a decimal number specifying the index block 
size. For INDEX files, the default value is 
one sector (256 bytes). For EC and NB files, 
the default value is three sectors (768 
bytes). The index block size cannot exceed 
the maximum disk block size established by the 
sysgen procedure. isize may not exceed 255. 


INDEX specifies that the file type to be allocated 
is indexed, 


lrecl is a decimal number specifying logical record 
length in bytes. It cannot exceed 65,535 
bytes; its default is 126. The logical record 
length is meaningful only for indexed and 
nonbuffered indexed files. 


NB specifies that the file type to be allocated 
is nonbuffered indexed, 


% 


Functional Details: 


A temporary file is allocated on the temporary volume. 


To assign this file, sufficient room must exist in system space 
for three buffers, each of the stated size. Therefore, if bsize 
or isize is very large, the file cannot be assigned in some 
situations. A maximum block size parameter is established in the 
system at sysgen time. The bsize and isize cannot exceed this 
constant. 


To assign an EC or NB file, sufficient room must exist in system 
space to contain only the index block of the stated size. The 
data blocks for EC and NB files are not buffered in system space 
and thus are not constrained to the sysgened block size. 


The TEMPFILE command can be entered in task loaded mode and. task 
executing mode. 
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Examples: 


TE 2,CO,64 


TE 14,1N,126 


TE 5,EC 


TE 7,NB,240/250/5 
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Allocates, on the temporary 
volume, a contiguous file with a 
total length of 64 sectors (16kb) 
and assigns it to the _ loaded 
task's lu2. 


Allocates, on the temporary 
volume, an index file with a 
logical record length of 126 
bytes. The buffer size and index 
block size default to one sector. 
The file is assigned to 1ul4 of 
the loaded task. 


Allocates, on the temporary 
volume, an extendable contiguous 
file with default data block size 
of 64 and index block size of 3 
sectors. The file initially 
contains no records, and has a 
record length of one sector (same 
as a contiguous file). The file 
is assigned to lu5 of the task. 


Allocates, on the default 
temporary volume, a temporary 
nonbuffered indexed file with 
logical record length of 240 
bytes, data block size of 250 
sectors, and index block size of 
5 sectors. The file initially 
contains no records. The file is 
assigned to lu7 of the task. 
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2.55 VOLUME COMMAND 


The VOLUME command sets or changes the name of the default user 
volume. It may also be used to query the system for the current 
names associated with the user, system, roll, spool, or temporary 
volume. 


Format: 


VOLUME voln 


Parameter: 


voln is a 4-character volume identifier. If this 
parameter is omitted, alli current default 
user, system, roll, spool, and temporary 


volume names are displayed. 


Functional Details: 


Any commands that do not explicitly specify a volume name use the 
default user volume. No test is made to ensure that the volume 
is actually online at the time the command is entered. If voln 
is not specified, the names of the current default volumes’ are 
output to the user console. 


The default user volume is initially set to the system volume or 
the default user volume (set at MIM sysgen time) when the user 
signs on. If no volume was specified at MTM sysgen, the default 
is the system volume. This command may be entered in command 
mode, task executing mode, and task loaded mode. 


Example: 


VOL 
USR=MTM SYS=MTM SPL=M67B TEM=M301 RVL=MTM 
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When MTM is used in conjunction with the new spooler, SPL/32, the 
spool volume is not displayed by the VOLUME command. 


Example: 


VOL 
USR=MTM SYS=MTM TEM=M301 RVL=MTM 
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2.56 WFILE COMMAND 

The WFILE command writes a filemark on magnetic tapes, cassettes, 
and direct access files. 

Format: 


WFILE [fd,] lu 


Parameters: 


fd is the file descriptor of the file or device 
to which a filemark is to be written. 

lu is the lu to which the device or file is 
assigned. If lu is specified without fd, the 


operation is performed on the specified lu 
regardless of what is assigned to it. 


Functional Details: 


The WFILE command can be entered in task loaded mode. 


Examples: 
WF 1 Causes a filemark to be written on 
the device or file assigned to lul. 
WF M300:AJM.OBJ,4 Causes a filemark to be written on 


file AJM.OBJ, which is assigned to 
lu4 on volume M300Q. 
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2.57 XALLOCATE COMMAND 


The XALLOCATE command is used to create a direct access file. 


Format: 


XALLOCATE fd, 


Parameters: 


fd 


CONTIGUOUS 


fsize 
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is the file descriptor of the file to be 
allocated. 


specifies that the file type to be allocated 
is contiguous. 


is a decimal number indicating file size which 


is required for contiguous files. It 
specifies the total allocation size in 
256-byte sectors. This size may be any value 


up to the number of contiguous free sectors 
existing on the specified volume at the time 
the command is entered. 
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keys 


EC 


bsize 


isize 


INDEX 


lrecl 


NB 


[TAM 


specifies the write and read protection keys 
for the file. These keys are in the form of 
a hexadecimal halfword, the left byte of which 
signifies the write key and the right byte the 
read key. If this parameter is omitted, both 
keys default to 0. 


specifies that the file type to be allocated 
is extendable contiguous. 


is a decimal number specifying the physical 
block size to be used for buffering and 
Gebuffering operations on indexed files or 
Gata communications devices. When INDEX, EC, 
or NB is specified, bsize represents the block 
size in sectors of the physical data blocks 
containing the file. When ITAM is specified, 
bsize represents the buffer size in bytes. 
For INDEX files and ITAM buffers, this 
parameter cannot exceed the maximum block size 
established by the system generation (sysgen) 


procudure. For EC and NB files, this 
parameter may be any value between 1 and 255 
inclusive. If bsize is omitted, the default 


value for INDEX files and ITAM buffers is 256 
bytes (one sector). For EC and NB files, the 
Gefault is 64 sectors. 


is a decimal number specifying the index block 
size. For INDEX files, the default value is 
one sector (256 bytes). For EC and NB files, 
the default value is three. sectors (768 
bytes). The index block size cannot exceed 
the maximum diskblock size established by the 
sysgen procedure. Neither bsize nor isize may 
exceed 255. 


specifies that the file type to be allocated 
is indexed. 


is a decimal number specifying the logical 


record Length of an indexed file or 
communications device. Lt cannot exceed 
65,535 bytes. Its default is 126 bytes. It 


may optionally be followed by a slash (/) 
which delimits lrecl from bsize. 


specifies that the file type to be allocated 
is extendable contiguous. 


specifies that the fd to be allocated is an 
ITAM buffered communications device. 


48-043 FOO RO1 


Functional Details: 


The XALLOCATE command is different from the ALLOCATE command _ in 
that if fd is an existing file, it is deleted and reallocated. 
If fd does not exist, it is allocated. 


If the fd to be allocated is a device name instead of a filename, 
a DEL-ERR TYPE=VOL occurs. . 


The XALLOCATE command can be entered in command mode, task loaded 
mode, and task executing mode. 
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2.58 XDELETE COMMAND 
The XDELETE command is used to delete one or more files. If the 
file does not exist, no error is generated. 
Format: 
XDELETE fd; [}fd2...,fdn| 


Parameter: 


fd is the file descriptor of the file to be 
deleted. 


Functional Details: 

A file can only be deleted if it is not currently assigned to a 
task and its write and read protection keys are 0 (X'0000'). 

An MTM user can only delete private files. 


Example: 


XDEL FIXD:08323240.817,RADPROC.FTN 
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CHAPTER 3 
MTM/NON-MTM TASK INTERFACES 


3.1 INTRODUCTION 


Multi-Terminal Monitor (MTM) allows the terminal user to transfer 
control of a terminal to tasks other than MTM and then return the 


terminal to MTM control in an orderly fashion. This orderly 
transfer of control is accomplished via the use of interface 
protocols that are invoked by specific MTM commands. The MTM 


terminal user can interface with: 


® foreground tasks, 
@e HASP tasks, and 


e ITC/RELIANCE tasks. 


3.2 INTERFACING WITH A FOREGROUND TASK 


The foreground interface allows an MTM user to connect an MTM 
terminal to any specified foreground task selected via the 
following command: 


Format: 


$foreground task-id 


Parameter: 


foreground task-id is a task-id of 1- to 7-characters 
specifying the selected foreground task 
to which the MTM terminal is to. be 
connected. The following task-ids are 
restricted and cannot be used: 


HASP 
-MTM 
-SPL 
ECM 
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Functional Details: 


This feature is available to all MTM users that have the 
$foreground privilege. 


This command can be entered in command mode as long as no CSS _ is 
active. This command is not available in batch mode. While a 
terminal is connected to a foreground task, all MTM messages’ to 
that terminal are ignored. 


The foreground task to which this command is directed must have 
particular characteristics and options enabled in order to 
establish, maintain, and terminate the interface. The foreground 
task must be linked with option UNIVERSAL and must be able to 
send and receive messages via SVC 6. For further information 


regarding SVC 6 use, refer to the OS/32 Supervisor Call (SVC) 
Reference Manual. 


Example: 


$XYZ 


In this example, the MIM terminal issuing the §$XYZ command 
becomes connected to the foreground task identified as XYZ. 
A subsequent DISPLAY USERS command from an MTM terminal will 


display the terminal transferred to the foreground task's (XYZ) 
control as shown: 


DAVE - NUI.L: @$XYZ 


3.2.1 Programming Details 

The foreground task selected with the $FGRND command must have 
the following interface and a message buffer ring with message 
entries enabled. The task-id may have no more than seven 
characters. 


The selected task gets the following message from .MTM: 


ADD terminal-dn,priv-acc,group-acc,userid <CR> 


The foreground task must now assign the terminal with terminal-dn 
and immediately send the following message to .MTM: 


$STA terminal-dn, status <CR)> 
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To return the terminal to MTM control, the foreground task should 
close the terminal and send the following message to .MTM: 


$END terminal-dn<CR> 
MTM assigns the terminal and the user returns to MTM control. 
Parameters: 


terminal-dn device name of the user's terminal (variable 


length from two to five characters including 
we") 


priv-acc user's private account number (fixed length of 
five characters, right justified, leading 
zeros.) 

group-acc user's group account number (fixed length of 
five characters, right justified, leading 
zeros) 

userid userid under MTM (fixed length of eight 


characters left justified) 


status returned from foreground task: 


X'30' all OK - foreground task has assigned 
the terminal. 


X'31' assign-errors - terminal was not 
assigned by the foreground task (.MTM 
reports TASE-ERR to the user). 


X'39' space error - terminal would have 
exceeded the maximum number of allowed 
terminals. (.MTM reports TSPC-ERR to 
the user.) 


<CR> carriage return (X'OD') 


Functional Details: 


Every ten seconds, MTM tries to reassign the terminal; i.e., if 
the foreground task closes the terminal or goes to end of task 
without sending a $END message, the user terminal remains 
unassigned no longer than 10 seconds. 
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3.3 HASP INTERFACE 

The HASP interface allows an MTM user to communicate with a 
specified HASP control task in the foreground. The option for 
the HASP interface must be enabled at MTM sysgen in order for it 
to be available to MTM users. When the HASP task is started, the 


optional start parameter OUT=#/MTM must be used to allow messages 
to be output to MTM. 


Format: 
SHASPxx 
Parameters: 


XX is a two-character alphanumeric extension of 
the HASP control tasks foreground id. 


Functional Details: 


Option UNIVERSAL is required when linking the HASP_ task. Once 
the $HASP command has been executed, the MTM terminal is then in 
HASP mode. The HASP mode read prompt is: 


All commands entered on the terminal are sent to the specified 
HASP task. All commands starting with a § are prefixed with the 
HASP message command and then sent to the specified HASP task. 
All messages sent by HASP to the terminal are displayed in the 
following format: 


HASPxx> message..... 


When the user is ready to return the terminal to MTM control, the 
following command is used: 


SMITM 


The terminal is then returned to MTM control. 
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The $HASPxx command can be entered in command mode only. No task 
can be loaded or executing, no CSS active, and the user must not 
be in batch mode. While in HASP mode MTM messages from other 
users and the system operator can be displayed on the HASP 
terminal. 


The specified HASP task is set to the same private and group 
account number asthe user. If $MTM is entered, the specified 
HASP task remains on these accounts and continues”) sending 
messages to the user terminal until another user connects to the 
same HASP task or until signoff. 


Example: 


SHASPO3 


This example selects the HASP task with the taskid HASPO3 in the 
foreground. The terminal is now in HASP mode (if no errors 
occurred. ) 


3.4 ITC/RELIANCE INTERFACE 


The environmental control monitor (ECM) provides facilities for 
terminal users to transfer control of their terminals between 
Reliance and MTM, or between different Reliance environments, 
without use of the system console or a Reliance controller's 
terminal. For details about the use of the ECM, refer to the 
Environmental Control Monitor/32 (ECM/32) Systems Programming and 
Operations Manual. 
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CHAPTER 4 
PROGRAM DEVELOPMENT 


4.1 INTRODUCTION 


This chapter is written as a program development tutorial session 
for new to intermediate users. The program development commands 
enable you to easily create a program and modify, maintain, and 
execute it from the terminal. 


4.2 CREATING A SOURCE PROGRAM 


To create a source program that will exist in a_esingle source 
file (language environment), enter a program development language 
command with a user-specified filename. Source filename 
extensions are program-supplied and language dependent. The 
language command entered must be consistent with the language of 
the source file. When a language command is entered, a file is 
allocated (if it does not already exist) with the user-specified 
filename and program-supplied filename extension, and the’ editor 
is loaded and started. If the file exists, it is set as the 
current program (EDIT is not loaded. ) 


Table 4-1 lists the program development language command = syntax 
and program-supplied filename extensions. 


TABLE 4-1 PROGRAM DEVELOPMENT LANGUAGE COMMANDS 


Cee een ee 


(using optimizing 
compiler ) 


H H { PROGRAM 
DEVELOPMENT 
LANGUAGE H COMMAND SYNTAX {FILENAME EXTENSIONS ; 
| PS SSSR SSS SPE SSSR SS SS SSS RS SSSR ES SSS SSE SS RSS SE ESS SSS Teese SS | 
| CAL/32 ' CAL [[{voln:] filename] ' .CAL 
i 
| CAL Macro/32 | MACRO [[voln:] filename] | .MAC 
| FORTRAN VII | FORT [{[voln:] filename} | .FTN H 
i H (using development H H 
H { compiler ) H i 
i FORTRAN VII | FORTO [[voln:] filename] | .FTN 
i i 
i 
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TABLE 4-1 PROGRAM DEVELOPMENT LANGUAGE COMMANDS (Continued) 


i ( { { 
' | ] { 
H DEVELOPMENT | 
{ LANGUAGE i COMMAND SYNTAX iF [LENAME EXTENSIONS | 
|} FORTRAN VII { FORTZ [f{voln:] filename] {| .FTN H 
H i (using the universal H H 
compiler) 
i H 
{| COBOL | COBOL [[voln:} filename] {| .CBL H 
| REPORT | RPG [[{voln:} filename] | «RPG H 
| PROGRAM i 
| GENERATOR 1 i 
{ { ( t 
! Y 1 ' 
H | PASCAL [[voln:] filename] {| .PAS H 


Pascal 


eter tm amet ey eee ee a er 


Program development language commands automatically set up 
certain processes that will be used for the remainder of the 
development effort. These processes are: 


e Assignment of the standard source file language extensions, 

e The compiler or assembler to be used, 

e The standard Perkin-Elmer run time libraries to be linked, and 
e The language tab character, a back slash, (\), and tab 


settings pertinent to the specified language, (displayed when 
the editor is entered). 


These automatic specifications free you from constantly having to 
remember them. The user-supplied filename with the 
program-supplied extension will identify the source file 
throughout the program development session. 


Once the editor is loaded and started, the full range of Edit 


commands are available to create the source file. See the OS/32 
Edit User Guide. 
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Example: 


*FORT PROG1L 

** NEW PROGRAM 
-EDIT 

-G PROG1.FTN 
-O TA = \,7,73 
-O COM = CON: 


(edit session) 


>SAVE * 

> END 

-WORK FILE = M67B: PROG1.000/P 

~RENUMBERED INPUT FILE AVAILABLE, M67B: PROG1L.FTN/P 


In this example, the FORTRAN language command entered with a 
user-supplied filename allocates an empty file, PROGI1.FTN, and 
loads and starts the editor. The FORTRAN tab settings are _ set 


and displayed. The filename you specify is set as the current 
program and is always accessed and/or executed if you do not 
specify another filename. You can start to enter your program 


after these messages are displayed: 


** NEW PROGRAM 
-EDIT 
? 


You can also create a source file by entering a language command 
without a filename. Then enter the EDIT command with a filename. 
The EDIT command allocates a file and loads and starts the 
editor. You can employ all of the Edit commands to create your 
source file. 


Example: 


* FORT 
*EDIT PROG1 
-EDIT - PROG1.FTN 


(edit session) 


»>SAVE* 
> END 
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The FORT command creates the language environment. The EDIT 
command entered with PROG] loads and starts’ the editor and 
allocates PROGI1.FTN for the source file that will be created via 
the Edit commands. PROG1L.FTN is saved and the edit session is 
ended. 


4.2.1 Creating a Data File 


To create a data file, save the source program file to disk, and 
clear the edit buffer by deleting all lines currently in the 
buffer. . 


Example: 


> SAVE * 
»DELETE 1- 
> AP 


(use the editor to create PROG1.DTA) 


»SAVE PROG1.DTA 
> END 


In this example, PROG1.FTN is saved and then cleared from the 
edit buffer. The Edit APPEND command allows data to be entered 
in the data file. The data file is saved, and the edit session 
is terminated with the END command. 


4.3 EXECUTING A PROGRAM 


The program development EXEC command loads and runs’ the current 
program. 


Example: 


* EXEC 
** EXECUTION OF PROG1.FTN FOLIOWS: 
-END OF TASK CODE=0 


This example assumes that PROGI1.FTN already exists as the current 
program. The EXEC command loads and runs the current program, 
PROG1.FTN, and displays a zero end of task code (if no errors 
occurred). A nonzero end of task code indicates an error was 
encountered. 
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4.4 MODIFYING A PROGRAM 


To modify your program, enter the appropriate language command 
with the filename of the source file to be modified. Enter the 
EDIT command to access the editor. 


Example: 


*FORT PROG1 
*EDIT 
-EDIT - PROG1L.FTN 


(edit session to modify PROG1) 


>SAVE* 
> END 


In this example, the FORTRAN language command is entered with the 
filename PROG]. The editor is accessed via the EDIT command, and 
the name of the current program is displayed. The editor is used 
to modify the source file, PROGL. 


4.5 RE-EXECUTING A MODIFIED PROGRAM 


When the EXEC command is issued, the source program is compiled, 
linked, and executed, creating object and image modules. If the 
source file is subsequently modified, the dates assigned to the 
previously compiled object and previously linked image modules 
will not be current. 


Dates and times are assigned to source, object, and image modules 
when they are created. The dates are stored in the _ system 
directory. 


The EXEC command causes the object and image modules to be 
datechecked. They are then compiled and/or linked if they are 
out of date. The EXEC command then loads and runs the _ image 
program. 


Example: 


*EXEC PROGI1 , 

-FORTRAN PROG1.FTN 

-END OF TASK CODE=0 

-LINK PROG1.OBJ 

-END OF TASK CODE=0 

** EXECUTION OF PROG1 FOLLOWS: 
-END OF TASK CODE=0 
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This example assumes that PROGI.FTN already exists. The EXEC 
command, entered with PROGI1, compiles, links, and then executes 
the image program. A zero end of task code is displayed after 
each process if no errors were encountered. 


The program development RUN command can also be used to execute 
a program. The RUN command does not datecheck, compile, or link. 
It simply runs a program that was already compiled and linked. 


Examp.ie: 


*RUN PROG1 
**x* EXECUTION OF PROG1 FOLLOWS: 
-END OF ‘4.5K CODE=0 


If the EXEC or the RUN command is entered without a filename, the 
current program is executed. If there is no current program, 
this message is displayed: 


** CURRENT PROGRAM NOT SPECIFIED 


If you only want to compile a program without linking or 
executing it, the program development COMPILE command can be 
used. The program development COMPLINK command compiles’ and 
links a program, if mecessary, but does not execute it. The 
nroaram development LINK command links the object program but 
does not. execute it. These commands are explained fully in their 
respect.ive sections. 


4.% EXECUTING MULTIPLE PROGRAMS AS A SINGLE PROGRAM 


“« source program exists in multiple source files (multi-module 
environment), you must include the file descriptors (fd) of each 
source file in an environment descriptor file (EDF). The EDF 
retains the identity of all the source files in the multi-module 
environment that will be used to create a program. 


When you enter the program development ENV command, you’ indicate 
that your source program exists in more than one file and is to 
be created in a multi-module environment. The ENV command 
creates the multi-module environment and allocates an EDF to 
contain the fds of the source files. 


Example: 
*ENV ALLPROG 


** NEW ENVIRONMENT 
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In this example the ENV command with the user-specified EDF name, 
ALLPROG, creates the multi-module environment. 


No language extension is specified with the EDF filename since 
each module can be written ina different language. Attempting 
to enter an extension will cause an error. The user-specified or 
Gefault volume is searched for ALLPROG. If it is not found, an 
empty file named AILLPROG is allocated, and the message, NEW 
ENVIRONMENT, is displayed. The EDF is now ready to receive the 
fds of the multiple source files. The program development ADD 
command is used to add source program fds to the the multi-module 
environment. 


Example: 


*ENV ALLPROG 

** NEW ENVIRONMENT 
*ADD PROGL.FTN 
*ADD PROG2.CBL 


The multi-module environment is created and an EDF, AI.LPROG, is 
allocated via the ENV’ command. The ADD command adds the fds, 
PROGL.FTN and PROG2.CBL, to the multi-module environment. 


When the ADD command is entered with a user-specified fd, the EDF 
is searched for that fd. If the fd does not already exist in the 
multi-module environment, it is added. If it already is in the 
multi-module environment, this message is displayed: 


**x* FILENAME CONFLICT - ENTRY NOT ADDED 


You must rename the file or remove the existing entry from the 
environment. 


The program development LIST command displays the fds in the 


multi-module environment, and the program development REMOVE 
command removes fds from the multi-module environment. 
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Example: 


*LIST 

** CURRENT ENVIRONMENT = ALLPROG 
-PROG1.FTN 

-PROG2.CBL 

*REMOVE PROG2 

*LIST | 

** CURRENT ENVIRONMENT = ALLPROG 
-PROG1. FTN 

x EXEC 

** EXECUTION OF AILPROG FOLLOWS: 
** END OF TASK CODE=0 

> 


The LIST command displays PROGL.FTN and PROG2.CBL as the fds in 
the multi-module environment. The REMOVE command removes PROG2. 
CBL and the LIST command displays the contents of the 
multi-module environment. The EXEC command runs the program, 
ALI.PROG. 


If the ADD or REMOVE command is entered without an fd or if the 
fd is incorrect, this message is displayed: 


** SYNTAX ERROR 


Not all program development commands are available in both 
language and multi-module environments. Table 4-2 shows the 
commands that are available in the environments. 


TABLE 4-2 PROGRAM DEVELOPMENT 
COMMAND AVAILABILITY 


H { MULTI- | 
! COMMAND } LANGUAGE {| MODULE | 
| Soe eenesenewcneensewerenensese| 
i ADD i x { 
| COMPIT.E {| x H x H 
;| COMPLINK } x H x { 
i EDIT H x H x H 
| ENV x 
i EXEC i x H x { 
| LINK | x 1 x H 
i LISt 1 x 
i REMOVE | { x { 
i RUN i x x i 


ee me ee ee a ee a eR Le Ue EO ee 
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If a command that is meaningful only in a multi-module 
environment is entered in a language environment, this message is 
displayed: 


** NOT IN MULTI-MODULE ENVIRONMENT 


In order to re-access a source program, modify the source file, 
and include it in a multi-module environment, enter the ENV 
command followed by the EDIT command and use the editor to modify 
the source file. 


Example: 


*ENV ALLPROG 

*ADD PROG1.FTN 

*LIST 

** CURRENT ENVIRONMENT = AL JI.PROG 
-PROG2.CBL 

-PROG1.FTN 

*EDIT PROG1L.FTN 

-EDIT PROG1.FTN 


(edit session) 


»>SAVE* 

> END 

* EXEC 

-PERKIN-ELMER OS/32 LINKAGE EDITOR 03/242 ROO-O1 
-END OF TASK CODE = 0 

**x EXECUTION OF ALLPROG FOLLOWS: 

-END OF TASK CODE = 0 

> 


The multi-module environment is entered via the ENV command and 
the EDF name, ALLPROG. PROGI1.FTN is added to the multi-module 
environment. The LIST command displays the filenames remembered 
in the EDF. The EDIT command accesses the editor to modify 
PROG1.FTN. When the edit session is ended, the EXEC command 
executes all the modules as one program, displaying an end task 
code of O after successful execution (if no errors were 
encountered). 
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4.7 HOW TO RECOVER FROM ERRORS 


If an error occurs in program compilation or execution, the 
process aborts, and a nonzero end of task code and an error 
message are displayed. 


Example: 


**x COMPILE ERRORS, LISTING ON PR: 


Program development makes it easy for the user to recover from 
errors. Compile errors are printed in the listing of the source 
file containing the error. 


Use the editor to correct the error and re-execute the program. 
The EXEC command will recompile only the modified modules. 


In some instances the EXEC command will recompile a_ successfully 
compiled module if the time between the creation of the source 
and object is less than one minute. 


See the OS/32 Link Reference Manual for an explanation of link 
error messages. 


4.8 ASSIGNING LOGICAL UNITS 


Program development defines and sets global variables that are 
associated with particular devices. These devices have default 
logical unit (lu) assignments. The global variable names’ and 
settings are displayed when the user signs on. Table 4-3 shows 
the variable names, their default settings, and lu assignments. 


TABLE 4-3 PROGRAM DEVELOPMENT 
DEFAULT VARIABLE 
SETTINGS AND LU 


ASS IGNMENTS 
i VARTABLE j; | LOGICAL | 
NAME i DEVICE {| UNIT i 
H iE ee ee ee ee H 
i SSYSIN i CON: 1 
H i i i 
! i) ' ' 
i SSYSOUT j; CON: i 2 i 
i SSYSPRT j PR: 3 i 
{ 1 Hy ! 
f ‘ ' ' 
i SSYSCOM j; CON: i 5 i 
| | | 
| CON: 7 


SSYSMSG 


en ee ee ee ees See ere ee a meee 
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Before running a program, ensure that the default variable and lu 
settings are appropriate. The input device can be changed from 
the console (default) to a pre-allocated file. 


Example: 
*SSYSIN FILE.IN 


Listings can be sent directly to a file rather than to the 
printer (default). 


Example: 
*SSYSPRT FILE.OUT 


The user has the option to specify lu assignments unique to a 
particular session. This is accomplished by creating a file, via 
the editor, that contains the new lu assignments. This file must 
be saved with the extension .ASN, and the last line in the file 
must be a $EXIT statement. The program development software will 
first search for a file with the extension .ASN. If no file is 
found, the default lu assignments are used. The HEI.P command 
provides all the information needed to create a new assignment 
file. 


Any variable settings you change supercede the default variable 
settings and are in effect until you change them again or sign 
off. 


4.9 PROGRAM DEVELOPMENT COMMANDS 


This section describes the functions of each of the following 
program development commands: 


ADD 
COMP ITE 
COMPLINK 


LIST 
REMOVE 
RUN 


48-043 FOO ROL 4-11 


4.9.1 ADD Command 


The ADD command adds the fds of source programs’ to the 
multi-module environment. These fds are remembered in the EDF. 
The ADD command is valid in the multi-module environment only. 


Format: 
ADD fd [,cssprod] 
Parameters: 
fd is the file descriptor of the source file to 
be added to the multi-module environment. 
cssprod is the name of the CSS procedure to be used 
when nonstandard compilation is required. 


Functional Details: 


The ADD command causes the current EDF to be searched for the 
specified fd. If the specified fd is not found, it is added to 
the multi-module environment. If the fd currently exists in the 
environment, the following message is displayed: 


** FILENAME CONFLICT - ENTRY NOT ADDED 


If the fd is omitted, or is in an incorrect format, this message 
is displayed: 


xx SYNTAX ERROR 


If the fd is entered without an extension, this message is 
displayed: 


x** EXTENSION OMITTED 
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The cssprod parameter must be used if the extension of the 
specified file differs from the language extensions listed in 
Table 4-1. If this parameter is omitted when you are using a 
nonstandard extension, the following messages are displayed: 


** NONSTANDARD EXTENSION 
** ALTERNATE CSS REQUIRED 


The alternate CSS cannot be specified by just a volume name. It 
must contain at least a filename. 
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4.9.2 COMPILE Command 


The COMPILE command compiles a source module and creates an 
object module if an up-to-date object module does not already 
exist in the language’ environment. The COMP ILE command 
conditionally compiles when the ALL parameter is specified in the 
multi-module environment. The COMPILE command does not execute 
a program. 


Language Format: 


voln: filename 
COMPITE | 4. ' 


ES 
Es 


Multi-Module Format: 


filename 


ATLL 


COMP ILE 


Parameters: 


voln: is a 1- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a 1- to 8-character alphanumeric name 
specifying the source file. If this parameter 
is omitted, the current program is’ the 
default. 

ALI specifies that all files in the multi-module 
environment whose fds are remembered in the 
EDF are to be compiled, if necessary. When 


this parameter is specified, the COMPILE 
command conditionally compiles all the files 
that are in the multi-module environment. 
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Functional Details: 


A successful compilation ends with a zero end of task code. An 
end of task code other than zero indicates a compilation error 
that will be printed on the listing created as a result of 
compile. 


If the environment is not set when you enter the COMPILE command, 
this message is displayed: 


** ENVIRONMENT NOT SET 


If a filename is not entered and a current program is not 
specified, this message is displayed: 


** CURRENT PROGRAM NOT SET 


If a specified filename does not exist, the following message _ is 
displayed: 


**x file NOT FOUND 


The COMPILE command functions are illustrated in Figures 4-1 and 
4-2. 
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Figure 4-1 COMPILE Command Functions in the Language 
Environment 
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Figure 4-2 COMPILE Command Functions in the Multi-Module 
Environment 
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4.9.3 COMPLINK Command 

The COMPLINK command performs a conditional compile and a 
conditional link by datechecking source, object, and image 
modules in language and multi-module environments. If all 


modules are up-to-date, this command does not perform any 
function. This command does not execute the program. 


Language Format: 


voln: filename 
COMPLINK - 


Multi-Module Format: 
COMPL INK 
Parameters: 


voln: is a 1l- to 4-character alphanumeric name 


specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a 1- to 8-character alphanumeric name 
specifying the source file. If this parameter 
is omitted, the current program is’ the 
default. Filename specification is meaningful 
in a language environment only. 


Functional Details: 


When the COMPLINK command is used in a multi-module environment, 
all the fds contained in the EDF are datechecked, compiled if 
necessary, and linked. 

If the specified source file is not found, the COMPILINK sequence 
terminates, and this message is displayed: 


**x fd NOT FOUND 
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If you specify any arguments in a multi-module envi 
message is displayed: 
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4.9.4 EDIT Command 


The program development language commands’ load and start’ the 
editor for you to create a source or data file. You can also 
enter the EDIT command to create or modify a source or data file. 


Format: 


voln: filename 
EDIT | | 


Parameters: 


voln: is a 1l- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a l1- to 8-character alphanumeric name 
specifying the file to be created or edited. 
If this parameter is omitted, the current 
program is the default. 


Functional Details: 


A language command entered with a filename loads and starts’ the 
editor if the file does not exist. However, if the language 
command is entered without a filename, enter the EDIT command 
with a filename to access the editor and create or modify a 
source file. 


If this command is entered in a NULL environment, the tab 
character is set and displayed, but the language tabs are not 
set. 


If this command is entered with a filename not contained in a 


multi-module environment, this message is displayed: 


xx FILENAME NOT [IN ENVIRONMENT 
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If this command is entered without a filename in the multi-module 
environment and there is no current program, this message _ is 
displayed: 


**x CURRENT PROGRAM NOT SPECIFIED 


If this command is entered without a filename when there is a 
current program in the multi-module environment, the name of the 
current program is displayed: 


**x EDIT - current program 


For information on the Edit commands, see Section 1.6.2, or the 
OS/32 Edit User Guide. 
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4.9.5 ENV Command 
The ENV command entered with an EDF name creates the multi-module 


environment and allocates the user-specified EDF, if necessary. 
This command can also be used to clear the current environment. 


Multi-Module Format: 


voln: filename 
ENV 
NULL 
Parameters: 
voln: is a 1l- to 4-character alphanumeric name 
specifying the volume on which the EDF 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a 1- to 8-character alphanumeric name 
specifying the EDF, filename.EDF. If this 
parameter is omitted, the default is the 
current program. The EDF extension is 


automatically appended and must not be entered 
by the user. 
NOLL clears the current environment. 


Functional Details: 


If the filename parameter is entered with an extension, this 
message is displayed: 


** SYNTAX ERROR 


If the ENV command is entered without a parameter, the name of 
the current environment is displayed: 


** CURRENT ENVIRONMENT = xxXxxXxxxx 
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If the environment was not set or the NULL parameter was 
specified, this message is displayed: 


** NO CURRENT ENVIRONMENT 


4-24 48-043 FOO RO1l 


4.9.6 EXEC Command 
The EXEC command datechecks source, object, and image modules in 
language and multi-module environments and compiles or links them 


if they are outdated. When the image program is current, it is 
loaded and run. 


Format: 


voln: filename 
EXEC ; [ "start parameters" | 


Parameters: 


voln: is a 1- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


Gefault is the user volume. 


filename is a 1- to 8-character alphanumeric name 
specifying the program to be run. If this 
parameter is omitted, the current program or 
EDF name is the default. 


"start are parameters particular to the program 
parameters" to be used. These parameters, usually 
specified with the operator START command, can 
now be specified with the program development 


EXEC command. Start parameters must be 
entered with beginning and ending quotation 
marks. 


Functional Details: 


When the EXEC command is entered in a multi-module environment, 
all modules contained in the EDF are compiled and linked if they 
are outdated. The task is then loaded and run. 


If start parameters are entered, they are invoked every time the 
task is executed. 


Start parameters must be entered with beginning and ending 
quotation marks. 
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EXEC command functions are shown in Figures 4-5 and 4-6. 
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Figure 4-6 EXEC Command Functions in the Multi-Module 
Environment 
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4.9.7 LINK Command 

The LINK command links the object module to yield the _ image 
module in language and multi-module environments. If no object 
module exists, the LINK command compiles the source module to 


yield the object module. The LINK command does not datecheck, 
load, nor execute a program. 


Language Format: 


voln: | filename 
LINK ‘e : 


Multi-Module Format: 


LINK 


Parameters: 


valn: is a 1l1- to 4-character alphanumeric name 
specifying the volume on which the source file 
resides. If this parameter is omitted, the 


default is the user volume. 


filename is a 1- to 8-character alphanumeric name 
specifying the files to be compiled and/or 
linked. If this parameter is omitted, the 
current program is the default. A filename is 
meaningful only in a language environment. 


Functional Details: 


When the LINK command is entered in a multi-module environment 
_and no ebject module exists, all source file fds contained in the 
EDF are compiled. The resulting object modules are then Linked. 
If a Link error occurs, the link sequence aborts, and this 
message is displayed: 


** LINK ERRORS: EXECUTION ABORTED 
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If a LINK command is entered when no’ environment was’ set, this 
message is displayed: 


** NO ENVIRONMENT SPECIFIED 


If there is a compilation error, the process ends with a nonzero 
end of task code, the link procedure never starts, and the process 
is aborted. This message is then displayed: 


** COMPILE ERROR - LINK NOT EXECUTED 


The LINK command also links all of the standard Perkin-Elmer’ run 
time libraries specified by the language extension assigned when 
the source file was created. 


4.9.7.1 Link Sequences 


The user can specify a link sequence by building a link file that 
must have the extension  .LNK. When the link sequence is 
specified, the system searches the default user volume for a file 
with the .LNK extension with a filename matching the EDF name or 
the current program. When it is found, it is executed. 


Example: 


*BUILD JOB.LNK 
BOESTABLISH TASK 

B> INCLUDE PROG1.0BJ 

B> INCLUDE PROG2.OBJ 
B>LIBRARY F7RTL,COBOL.LIB 
B>MAP PR: ,AD,AL,XREF 
B>BUILD PROG.TSK 

B>END 

B>ENDB 


If the user-specified link file is not found, the system uses’ the 
default link sequence. There is a default link sequence for each 
language environment. Following is an example of a default 
FORTRAN link sequence: 


>ESTABLISH TASK 

>INCLUDE current program 

> INCLUDE LIBRARY F7RTL.OBJ/S 
2OP DFLOAT, FLOAT, WORK=X3072 
>BUILD filename.TSK 

> END 
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The LINK command functions are shown in Figures 4-7 and 4-8. 
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48-043 FOO RO1 


SOURCE AND OBJECT PROGRAMS BEFORE LINK 


Pr Sas APT SFT KS OSL ASSESS T STK SSCS SSSCSCKCSCSCC SEK CERES SST se SEBO SFE Terr cls sere se 


->{PROG1. FTN} | PROG1.OBJ} 


ALLPROG. EDF 


-> | PROG2.CBL} 


H 
H 
| 
| 
{ 
H 
PROG2.OBJ} 
| 

| 


SOURCE AND OBJECT PROGRAMS AFTER LINK 


Seller se FSC SSRESKCLLASSSECCL ESSE KLE CSE KLECB HSH SEK ECTSEKCKCCRKESEeeres ese eatae es 


eee eo eee wee em ee ewe me me ee ee 


{PROGL.FTN{ {PROG2.OBJ} 
| it 1-> 
| 


PROG2.CBL] | PROG2 .OBJ | 


| i 

t i 

| i 

' | 

|} ALLPROG. TSK } NO 
i i EXECUTION 
' ' 

\ | 

i | 


i} 
wv 


6/20 {i | 6/20 


LINK 


SOURCE MODULE BEFORE LINK 


|PROG1.FTN} 
=i 
i 


ALLPROG. EDF 


-> | PROG2.CBL} 
1 


i 
| 
1 
{ 


SOURCE MODULE AFTER LINK 


ERE REKRRRBESEBESCFTSEKX SEEK RS EBC RKEMRRREE STARE EBETFSEKCEECSCESREESCSESERCSETFERECBTTKETSCEE 


|PROG1.FTN} {|PROG1.OBJ} 
i , | }-> 
| | ' 


PROG2.CBL} PROG2 .OBJ | 


EXECUTION 


| 
{} ALLPROG. TSK} NO 
| 

>| 

| 


t 
6 
4 
% 
iy 
4 


6/20 | 


be ee ee ee i 


mn ee ee ee ee ee ee ee ee we ee ee ee we we we ee ee ee ee Oe we me we wee we we we we we ee ee 
wee wee me ee we ee eee we ee ee we Se te we wre we ee we oe - 


Figure 4-8 LINK Command Functions in the Multi-Module 
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4.9.8 LIST Command 
The LIST command lists the fds of all the mult i-module 
environment programs that are contained in the current EDF. 
Format: 

LIST 


Functional Details: 


The LIST command causes a listing to be sent to the list device 
specified by SSYSPRT when lu assignments were made. When this 
command is entered, this message is displayed: 


** CURRENT ENVIRONMENT = current EDF 


If the LIST command is entered and no fds are in the multi-module 
environment, the following message is displayed: 


«* ENVIRONMENT EMPTY 


If an argument is specified with the LIST command, this message 
is displayed: 


**x TOO MANY ARGUMENTS 
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4.9.9 REMOVE Command 
The REMOVE command deletes specified source fds from the current 
multi-module environment. 
Format: 
REMOVE fd 


Parameters: 


fd is a file descriptor of a source file 
contained in the EDF. 


Functional Details: 


When the REMOVE command is entered, the current EDF is searched 
for the specified fd. When found, the fd is removed from the 
multi-module environment. If the fd is not found, the following 
message is displayed: 


xx FILENAME NOT IN ENVIRONMENT 


If the fd is omitted or is in an incorrect format, this message 
is displayed: 


** SYNTAX ERROR 


When all of the fds have been removed from the multi-module 
environment, this message is displayed: 


** ENVIRONMENT EMPTY 
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4.9.10 RUN Command 


The RUN command loads and runs the image program in language and 
multi-module environments. This command does not datecheck, 


compile, or link. 


Format: 


Parameters: 


voln: 


filename 


"start 
parameters" 


Functional Details: 


filename 
[start parameters" | 


is a 1- to 4-character alphanumeric name 
specifying the volume on which the _ image 
module resides. If this parameter is omitted, 
the default is the user volume. 


is a l- to 8-character name specifying the 
image module. If this parameter is omitted, 
the default is the current program. 


are parameters particular to the assembler 
or compiler being used. These parameters, 
usually specified with the operator START 
command, now can be specified with the program 
development RUN command. 


If a filename is not entered with the RUN command and a task with 
the filename of the current program does not exist in the 
language environment, this message is displayed: 


** fd NONEXISTENT 


See Section 4.9.6 for more information on start parameters. 
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Figures 4-9 and 4-10 illustrate the RUN command functions. 
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Figure 4-10 RUN Command Function in the Multi-Module Environment 
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Table 4-4 summarizes the functions of 
compile, link, and run a program. 
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SAMPLE PROGRAM DEVELOPMENT SESSIONS 

section presents coding examples using the program 
lopment commands. 
*FORT TEST Create FORTRAN language 


** NEW PROGRAM 


environment with the 


-EDIT FORT language command. 


Specify TEST as filename 
to be allocated. FORT com- 


(edit session) 


mand loads and starts 
editor with TEST.FTN as 


: current program. 
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*SSYSIN CON: 


*SSYSOUT CON: 
*SSYSLIST PR: 
*EXEC TEST 

-FORTRAN: TEST 


** COMPILE ERRORS, LISTING ON PR: 


*EDIT 
-EDIT - TEST.FITN 


(edit session) 


SAVE * 
> END 


*EXEC 
-FORTRAN - TEST 


(compilation sequence) 


-END OF TASK CODE=0 
-LINK - TEST 


(Link sequence) 


-END OF TASK CODE=0 


**x EXECUTION OF TEST FOLLOWS : 


(execution sequence) 


-END OF TASK CODE=0 
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Define and set new global 
variables. 


Execute TEST.FTN. 
Compile TEST.FTN. 
Compilation errors in TEST. 


Find and correct errors. 


Execute current program. 


Compile. 


Sucessful compilation. 
Link the newly created 
object module TEST.OBJ. 


Successful Link. New task 
now exists. 


Run the new task TEST.TSEK. 


4-37 


*EXEC 


** EXECUTION OF TEST FOLLOWS: 


(execution sequence) 


-END OF TASK CODE = 0 
*RUN 


** EXECUTION OF TEST FOLLOWS: 
(execution sequence) 


-END OF TASK CODE=0 


*EXEC NEWPROG 
** FILE NEWPROG.FTN NOT FOUND 


*MACRO 


*EXEC NEWPROG 
-MACRO - NEWPROG 
-CAL - NEWPROG 
-~LINK - NEWPROG 


(Link sequence) 


** EXECUTION OF NEWPROG FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=0 


Successful execution. 
Re-execute. 

Ensure program is compiled 
and linked. 

Compile, link unnecessary. 
Object and image up-to-date. 


Successful execution. 


Rerun. 


Execute NEWPROG. 

System finds NEWPROG.MAC. 
Cannot find NEWPROG.FITN. 
Specifiy MACRO command to 
access NEWPROG.MAC and enter 
a new language environment. 


Execute NEWPROG.MAC. 
Expand. 

Assemble. 

Link. 


Successful execution. 
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*EDIT — Edit current program. 
EDIT-NEWPROG .MAC 


(edit session) 


SAVE* 


>END 

* EXEC Execute current program. 
-MACRO - NEWPROG Expand. 

-CAL - NEWPROG Assemble. 

-LINK - NEWPROG Link. 


« 


(Link sequence) 


** EXECUTION OF NEWPROG FOL JIOWS: 


(execution sequence) 


. 


-END OF TASK CODE=0 Successful execution. 


Create multi-module envi- 
ronment with ENV command. 


*ENV BIGTASK BIGTASK.EDF allocated. 
** NEW ENVIRONMENT 
x*ADD SUB.CAL Add 3 module names to EDF. i 


*ADD MACRTY.CAL 

*ADD FTOR.FTN 

*LIst List all modules in EDF. { 
** CURRENT ENVIRONMENT=BIGTASK. EDF 

-SUB.CAL 

-MACRTY.CAL 

-FTOR.FTN 

*ADD SUBFUNC.FTN Add 2 more modules to EDF. H 
*ADD YSUB.MAC 
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*REMOVE SUB.CAL 
*FORT SUBFUNC 
~EDIT - SUBFUNC 


(edit session) 


*EDIT YSUB 


*ENV BIGTASK 

*EXEC 

-FORTRAN - FTOR.FTIN 
-FORTRAN - SUBFUNC.FTN 
-~MACRO - YSUB.MAC 


-CAL - MACRTY.CAL 
-LINK - BIGTASK 


(link sequence) 


END OF TASK CODE=0 


** EXECUTION OF BIGTASK FOLLOWS: 
(execution sequence) 


-END OF TASK CODE=2 


Remove fd from EDF. 


Make changes to SUBFUNC.FIN. 


Make changes to YSUB.MAC. 


Create multi-module envi- 
ronment 

Execute modules remembered 
in BIGTASK.EDF. 

FTOR.OBJ and YSUB.OBJ 
modules are outdated. 


Link BIGTASK. 


All objects are linked; 
appropriate RTLs are also linked. 


Execution errors traced to YSUB. 
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*MAC. Create language environment. 
*EDIT YSUB Correct errors in YSUB.MAC. 


(edit session) 


SAVE* 


>»END 

*ENV BIGTASK Enter multi-module environment. 
*EXEC 

-MACRO: YSUB .MAC YSUB.MAC object is outdated. 


Expand, assemble, and linkedit. 
-CAL - YSUB.MAC 
-LINK - BIGTASK 


(link sequence) 


** EXECUTION OF BIGTASK FOLLOWS: 


(execution sequence) 


-END OF TASK CODE=0 
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CHAPTER 5 
MULTI-TERMINAL MONITOR (MTM) BATCH PROCESSING 


5.1 INTRODUCTION 


In addition to interactive processing capabilities, MTM also 
supports concurrent batch processing, allowing the user to run 
multiple batch jobs from a single batch queue. This feature 
enables the user to effectively utilize the capabilities of the 
system with minimal interference to the interactive users. 


The number of concurrent batch jobs allowed at any time under MTM 
is set by the operator from the system console. This mumber 
cannot exceed 64. If more batch jobs are submitted than there 
are active jobstreams, MTM queues the requests until a jobstream 
becomes available. 


The batch queue is an indexed file containing the file descriptor 
(fd) of the jobs to be processed. Each job is identified in the 
queue by the fd of the command file. The batch queue is ordered 
in priority order and in first-in/first-out (FIFO) basis within 
a priority. 


Tasks executing in the batch environment run at a priority lower 
than or equal to the tasks in the terminal environment. Thus, a 
batch job executes when the system is not occupied with work from 
a terminal user. Batch jobs use the processor's idle time and 
therefore increase the efficiency of the system. 


5.2 BATCH COMMANDS 


The batch job file consists of a series of MTM user commands 
and/or command substitution system (CSS) calls. The commands 
presented in this section are unique to the batch environment. 


To submit a batch job a user must have created a batch job file 
on disk. This file must have a SIGNON command as the first 
record, and a SIGNOFF command as the last record. The only valid 
commands to be used between the SIGNON and SIGNOFF commands are 
MTM user commands (Chapter 2), program development commands 
(Chapter 4), batch processing conmmands, and calls to a CSS file 


(Chapter 6). A batch job file is not a CSS. Therefore, CSS 
commands, with the exception of $IF..., §$ELSE, and §ENDC, are 
invalid. Any command that can be used at a terminal can be used 


in the batch job file. 
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Example: 


of a single batch job file: 


SIGNON TEST1,1,PWD 
L TEST 1 

ST 

SIGNOFF 


Example: 


CSS to build a batch job file and submit job: 


x* ASM.CSS [MODULE ] 
xx 
xx @ 1 (MODULE TO BE ASSEMBLED) 
xx 
ae EXAMPLE: ASM EXIN 
xx 
$BU @1.J0B 
SIGNON @1 
XAL, @1.L0G, IN, 80 
LOG @1.LOG,5 
ASM/G @1l 
$IFE 0 
MESS LEE *** @1.JOB COMPLETE *** 
$ELSE : 
MESS LEE *** @1.JOB ERROR *** 
-$ENDC 
SIGNOFF 
$ENDB 
SUB @1.JOB,DEL 
INQ 
$EXIT 
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| INQUIRE | 


5.2.1 INQUIRE Command 


The INQUIRE command queries the status of a job on the _ batch 
queue. 


Format: 


t fay 
INQUIRE | fd eee ee o 


Parameters: 


fd identifies the job for which the status is 
desired. If fd is not specified, all jobs 
with account numbers the same as the user's 
are displayed. 


fdl specifies the file or device to which the 


display is output. If this parameter is 
omitted, the default is the user console. 


Functional Details: 


When this command is entered by a privileged user, information 
about all jobs’ on the system is displayed. Standard MTM users 
see just the jobs related to the user's private account. This 


command can be entered in command mode, task loaded mode, and 
task executing mode. 


Possible responses to the INQUIRE command are: 


JOB fd NOT FOUND 
JOB fd EXECUTING 
JOB fd WAITING BEHIND=n 


NO JOBS WITH YOUR ACCOUNT 
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Examples: 
INQ All jobs with the _ user account 
number are displayed. 


INQUIRE TASK.JOB The status of TASK.JOB is displayed. 
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5.2.2 LOG Command 


The user can invoke a batch job to produce a log of its commands 


by including the 


batch stream. 


Format: 


noc [fa] |, f 


Parameters: 


fda 


COPY 


NOCOPY 
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LOG command and the $COPY command within the 


’ 
as 


is the file descriptor of the log file or 
device. If no fad is specified, logging is 
terminated. If fd is a file, it must be 
previously allocated. Files are assigned EWO 
privileges so that logged output is added to 
the end of the file. If a log is active when 
a second LOG command is entered, the old log 
is closed and the new one is initiated. 


specifies that all output is written to both 
the terminal and the log device. 


specifies that all output, except messages, is 
written to the log device and not the 
terminal. Messages from other users and the 
operator are written to both the terminal and 
the log device. 


is a decimal number from 0O through 65,535 
specifying the number of lines after which the 
log file is to be checkpointed. If this 
parameter is omitted, the default is 15 Lines. 
If n is specified as O, no _ checkpointing 
occurs. 


Functional Details: 


The LOG and the SET LOG commands are the same. The command can 
be entered either way, and both formats perform the same 
function. 


Checkpointing may be done on any type of file. However, on 
contiguous files, the checkpoint operation is treated asa 
no-operation. On nonbuffered indexed and extendable contiguous 
files, the checkpoint operation is useful only if the file is 
being expanded. On indexed files it is possible that a 
significant amount of time may elapse between the time the data 
to be written to the disk leaves the user's buffer and the time 
that it is physically transferred to the disk. In these cases, 
checkpointing "flushes" the system buffers, as well as updating 
the file size in the directory. In general, checkpointing is 
justifiable only under very specific circumstances, such as when 
a very large amount of data is written to an indexed file over an 
extended period of time, without the file being closed. 


Example: 


LOG PR: 
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5.2.3 PURGE Command 


The PURGE command purges a submitted job from the batch queue. 


Format: 


PURGE fd 


Parameter: 


fd is the file descriptor of the job to be 
purged. Only jobs with the user = account 
number can be purged. 


Functional Details: 


If the specified job is executing, it will be cancelled or 
terminated. If the job is waiting to be run it will be removed 
from the batch queue. 


Example: 


PURGE TASK.JOB TASK.JOB is purged. 
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| SIGNOFF | 


§.2.4 SIGNOFF Command 


The last command in a batch stream must be the SIGNOFF command. 


Format: 


SIGNOFF 


Functional Details: 


When a terminal user signs off the system, these messages are 
displayed: 


ELAPSED TIME=hh:mm:ss CPUTIME=ut ime/ostime 
SIGNON LEFT=hh:mm:ss CPU LEFT=hh:mm:ss 
TIME OFF=mm/dd/yy hh:mm:ss 


The SIGNOFF command can be entered in command mode, task loaded 
mode, and task executing mode. 
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5.2.5 SIGNON Command 


SIGNON must be the first command in a batch job. 


Format: 


fd 
SIGNON userid ,actno,password | ,ENVIRONMENT= 
NULL [ =] 
[, CRUTIME=maxt ime ] 
[: classid=iocount, [, ...,Cclassid= iocount 2] | 
Parameters: 

userid is a l- to 8-character alphanumeric” string 
specifying terminal user identification. 

actno is a 5-digit decimal number’ specifying the 
terminal user's account number. This must be 
a valid account number in the AUF file and can 
never exceed 65,535. If this parameter is 
omitted, the password parameter should also be 
omitted. MTM will use the account number of 
the user submitting the batch job. 

password is a l- to l2-character alphanumeric” string 
specifying the terminal user's password. This 
parameter should be omitted if the actno 
parameter is omitted. MTM will use the 
password of the user submitting the job. 

ENV I RONMENT= fd is the file descriptor specifying the file 
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that will establish the user's environment at 
signon time. 


NULL specifies that the signon CSS procedure, 
USERINIT.CSS, should be ignored and the user 
will establish the environment at signon time. 
If the entire keyword parameter is omitted, 
MTM searches all online disks for the signon 


CSS procedure, USERINIT.CSS/P. The system 
volume, system account, is searched last. If 
USERINIT.CSS is found, MTM calls the CSS _ and 
executes the routine. If it is not found, MTM 


enters command mode. 


CPUTIME= maxtime is a decimal number specifying the 
maximum CPU time to which the batch job is 


limited. If this parameter is omitted, the 
default established at sysgen is used. If 0 
is specified, no limits are applied. The 


parameter can be specified as: 


mmmm:s3 
hhhh:mm:ss 
ssss 


classid= is one of the 4-character alphanumeric 
mnemonics, specified at sysgen, associated 
with each specified device or file class. 


iocount is a decimal number specifying the maximum 
number of I/O transfers associated with a 
particular device class to which the batch job 
is limited. If this parameter is omitted, the 


default established at sysgen is used. If 0O 
is specified, no limits are applied to that 
class. 


Functional Details: 


Between the SIGNON and SIGNOFF commands, any command or CSS call 
that is valid from the terminal is allowed. A SIGNON command 
cannot be followed by another command, on the same _ line, 
separated by semicolons. When ENVIRONMENT=NULL is specified, the 
colon is optional. This allows the user the ability to specify 
the null device (NULL:). 

The account number and password can be omitted if a batch job is 
submitted from a user terminal. If a batch job is submitted from 
the system console or via the Spooler, the account number and 
password must be specified. 

The ENVIRONMENT= parameter may be ignored, depending on the user 
account's privileges. 

Examples: 


SIGNON ME 

S ME,12,PSWD, CPUTIME=2:30:00,DEV1=150 
S ME,CPUTIME=120 

S ME,ENV=NULL, CPUTIME=120 


S ME,ENV=XYZ 
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5.2.6 SUBMIT Command 

The terminal user adds a job to the batch queue with the SUBMIT 
command. 

Format: 


SUBMIT fd [,DELETE] [,PRIORITY=priority] 


Parameters: 


fd is the file descriptor of the file submitted 
to batch. 
DELETE deletes the batch job file created to submit 


the batch job. If this parameter is omitted, 
the batch job file remains on the user volume. 


PRIORITY= priority is a decimal number which specifies 
the priority at which a batch job will run. 
The range of valid priority numbers is 
dependant upon the user's account privileges, 
sysgen options, and MTM's priority. The 
maximum range allowable is MTM's priority + 1 
through 255. If this parameter is omitted, a 
batch job will run at the default batch 
priority (the default batch priority is 12 
lower than MTM's) priority plus the value 
specified at MTM sysgen time for batch 
priority) or the Link priority (the priority 
established when the task was built), 
whichever is lower. 


Functional Details: 


The priority at which a batch job runs is’ relative to MIM's 
priority and the default batch priority established at MTM sysgen 
time. The u-task priorities are established at link time and can 
be reset with the PRIORITY parameter of the SUBMIT command. 
Interactive tasks run at the default priority of 12 priorities 
lower than MT. Batch jobs run at the default priority of 12 
lower than MTM plus the value specified at MTM sysgen time. If 
the MTM sysgen priority is set to equal 1 and MT's priority 
equals 128, interactive jobs will run at priority +12 (140), or 
12 lower than MTM; batch jobs will run at priority +13 (141), 13 
lower than MTM. 
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The rules for establishing priorities are: 


e Batch jobs can run at the same priority as interactive tasks 
but not higher than interactive tasks if the user account has 
this privilege enabled; otherwise they are run at (maximum) 
one priority lower than interactive tasks. 


e If a valid priority is specified, the batch job runs at that 
priority or the link priority, whichever is lower. 


e If the specified priority is invalid, the default priority is 
assigned by MTM, and the following message is displayed: 


WARNING - REQUESTED PRIORITY n ILLEGAL, n USED 


e If the specified priority is greater than 255, 255 is used. 


e If no u-task priority is specified with the SUBMIT command, 
the batch job runs at the default priority or the link 
priority, whichever is lower. 


The SUBMIT command can be entered in command mode, task loaded 
mode, and task executing mode. 


Example: 


Create a batch job stream from the terminal via the BUILD...ENDB 
sequence: 


BUIT.D TEST.JOB 
SIGNON ME,ENV=NUILL 
LOG PR: 

L TEST.TSK 

AS 3,PR: 

START 

SIGNOF 

ENDB 


Submit the job from the terminal for batch processing: 


SUBMIT TEST.JOB 
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Submit a batch job file and have it deleted after the batch job 
execution is complete: 


SUBMIT XY¥Z.JOB, DELETE 


Submit a batch job and have it run at the same priority as an 
interactive job: 


SUBMIT XY¥Z.JOB, P=129 


5.3 BATCH JOB SUBMISSION USING THE SPOOLER 


The Spooler is also used to submit batch jobs to the batch queue 
for execution under MT. Batch jobs submitted through the 
Spooler later can be resubmitted as a batch job through the 
terminal. 


5.4 ERROR HANDLING 


Any error that occurs in a batch job file causes automatic 
termination of the job, and a message is written to the log file 
or device. If a batch task pauses, the task is cancelled by MTM 
with an end of task code of 255, and the job is terminated, 
unless the batch task pause option was enabled at MTM_= sysgen. 
See Section 5.5. When a batch task completes, the end of task 
code can be tested by subsequent commands in the batch stream to 
Getermine if the task completed normally. 


5.5 BATCH TASK PAUSE OPTION 


This option allows a batch task to pause without being cancelled 
immediately by MTM. MTM logs the following message to the system 
console if a batch task enters the paused state: 


hh:nn:SS -MTM > task id BTCH TSK PAUSED 


In this message task id is the name of the batch task that has 
paused. The system operator has the option to cancel or continue 
the paused batch task. 
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5.6 EFFECT OF RESTRICTED DISKS ON BATCH JOBS 


When accounts with access to restricted disks are given 


read/write access, batch jobs are not affected. If read-only or 
no access is specified, messages are not displayed on the user 
console. If a submit file for a batch job is on a restricted 


Gisk and account O does not have read/write access, the following 
message is displayed on the system console: 


-MTM: BATCH ASGN-ERR TYPE=PRIV JOB=fa 
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CHAPTER 6 


COMMAND SUBSTITUTION SYSTEM (CSS) 


6.1 GENERAL DESCRIPTION 


The command substitution system (CSS) is = an 
OS/32 command language enabling the user to 
Gynamically modifiable commands that can be 
terminal or other CSS files and executed 
sequence. In this way, complex operations can 
the terminal user within only a few commands. 


e the ability to switch the command input stream to a 


device, 


e a set of logical operators to control the precise sequence 


commands, 


e the ability to pass both positional parameters 


extension to the 
establish files of 
called from the 
in a_ predefined 
be carried out by 
CSS provides: 


file or 


of 


and keyword 


parameters to a CSS file so that general sequences take on 
specific meaning when the parameters are substituted or the 
keyword encountered in the CSS, 

e the ability to specify replacement characters within a CSS 


line to alter the function of the line when 


executed, 


@e the ability to perform decimal and hexadecimal computation and 


Css 
and division), 


conversion within a line 


multiplication, 


@e the ability to use standard local and global variables or 


global and new internal variables’ that 


(addition, 


subtraction, 


new 
introduce extended 


power and flexibility to variable usage within a CSS, 


e the ability to perform searches within specified CSS calls 


of 
and 


subtract specific sections the call 


replacements within the CSS, 


e the ability for one CSS file to call another, 


a subroutine, 
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to 


and use them as 


in the manner of 


so complex command sequences can be developed. 


A CSS file is simply a sequential text file. It can be a deck of 
cards, a magnetic tape, or a disk file. An example of a_e simple 
CSS file is: 


*THIS IS AN EXAMPLE OF A CSS FILE 
LOAD TEST.TSK/G,5 

ALLOCATE XXXDIX.DTA,CO, 40 

AS 1, INPUT.DTA 

AS 2,XXXDIX.DTA;AS 5, CON: 

ASSIGN 3,PRT: ; *LU3-LINEPRINTER 
START 

$EXIT 


NOTE 


Blank lines are ignored. The semicolon 
allows more than one command to be 
entered on the same _ line. Null CSS 
commands (;;) are ignored. An asterisk 
introduces a comment. 


6.2 CALLING A CSS FILE 


A CSS file is called and executed from the terminal by specifying 
the file descriptor (fd) of the CSS file. If only the filename 
is specified, MTM appends the extension.CSS and first searches 
the user default volume in the user's private account. If the 
file is not found, the system volume system account is searched. 
If the volume name or account class is specified by the user, a 
system default will not be tried. A user must have the CSS 
privilege in order to call CSS files in the user's’ private 
account or group. If not privileged he may only call system 
CSS's. If the user also has the privilege to specify account 
numbers instead of classes, he may call a CSS in any account. If 
the leading characters of a CSS fd are the same as a command, MTM 
assumes a command: 


Example: 
CLO.CSS CLOSE MTM assumes the CLOSE command. 
AS3.CSS ASSIGN 3 MTM assumes the ASSIGN commana. 


By specifying a volume name and/or extension, a CSS file that 
otherwise would conflict with an MTM command can be called. 
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Example: 


M300: CLOSE 
M300:CLOSE.CSS 


6.3 USE OF PARAMETERS 


The CSS call can have parameters. The parameters are entered 
after the CSS fd and are separated from it by one character 
space. If there is more than one parameter, each is separated by 
commas. If a parameter contains the double quote character ("), 
or single quote character (') all parameters up to the next 
double quote character are passed as one parameter. Null 


parameters are permitted. 


Example: 


ABC Pl, "P2A, P2B" calls CSS file ABC.CSS on the default volume 
with two parameters. Parameter 1 is Pl. Parameter 2 is P2A, 
P2B. 


JUMP ,,C calls CSS file JUMP.CSS on the default volume with three 
parameters; the first two are null. 


Within a CSS file, a parameter is referenced by the use of the 
special symbol “@n" where nm is a decimal integer number 


indicating which parameter the user is referencing. Parameters 
are numbered starting with 1. Parameter O has special meaning 
and is defined later in this section. The first parameter is 


referenced by @1, the second @2, etc. A straightforward text 
substitution is employed. 


Example: 


A CSS file ROG consists of: 


LOAD el 
START @3,@2 


It is called as follows: 


ROG PROGRAM, NOLIST, 148 
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Before each line of the CSS file is decoded, it is preprocessed, 
and any reference to a parameter is substituted with the 
corresponding text. Thus, the file ROG with the previous call is 
executed as: 


LOAD PROGRAM 
START 148,NOLIST 


@l is replaced with PROGRAM (the lst parameter in the CSS call). 
@3 is replaced with 148 (the 3rd parameter in the CSS call). 
@2 is replaced with NOLIST (the 2nd parameter in the CSS call). 


Example: 


All of the following references to Parameter 12 are valid 
expressions: 


@l2 or @1L2ABC or @12.EXT 


This mechanism allows concatenation. For instance, if the first 
command in file ROG were LOAD @1.TSK, only those files with the 


extension .TSK would be presented to the loader. Concatenation 
of numbers requires’ care. 123@1 references Parameter 1, but 
@1123 is a reference to Parameter 1123. A reference to a 


nonexistent parameter is null. 


The multiple @ facility enables a CSS file to access parameters 
of higher level files. CSS files can call each other toa 
maximum depth specified at sysgen time. Thus, @@2 in a CSS file 
refers to the second parameter of the calling file. 


Example: 


Given the CSS call: 


CSS1 argl,arg2 


and assuming that in file CSS1 there is another call: 


CSS2 arg3,arg4 
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the following references can be made in CSS2: 


@l = arg3 
@2 = arg4 
@@l = argl 
@@2 = arg2 


If a multiple @ sequence is such that the calling level referred 
to is nonexistent, the parameter is null. 


Parameter @0 is.a special parameter used to reference the name of 
the CSS file in which it is contained. Parameter @0 is replaced 


during the preprocessing of the command Line with precisely the 
same fd used to call the file. 


Example: 


A CSS file consists of: 


AS 1,80 
SEXIT 


If this file is called from the card reader (CR:), then 1lul is 
assigned to the card reader (CR:). Likewise, a call from the 
magnetic tape (MAGI1:) results in: 


AS 1,MAG1: 


6.4 USE OF KEYWORDS 


In the previous section the usage of positional parameters was 


presented. The CSS language also provides a means of passing 
keywords ina CSS call. Again a straightforward substitution 
procedure is applied. Keywords enable the user to explicitly 


specify a value that is subsequently substituted for each 
reference of the keyword encountered within the CSS. The value 
of a Keyword is defined in the CSS call in the following format: 


Format: 


keyword = [ parameter ] 
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Parameters: 


keyword is the 1- to 8-character name of a keyword. 
The characters must be alphabetic (A-Z). 


= is a required delimiter between a keyword and 
its assigned value for the CSS call. This 
delimiter must immediately follow the keyword 
(no blanks allowed). 


parameter is a character string which replaces’ the 
keyword reference with the css. Null 
parameters are allowed. 


Functional Details: 


The following rules apply for the use of keywords within a CSS 
file and the relationships between keywords and positional 
parameters. 


e The leading blanks of a Keyword parameter are skipped unless 
they are included with the parameter through the use of single 
('...') or double ("...") quotes. 


@e All characters between single or double quotes belong to the 
same parameter. This allows the user to define a parameter 
with leading blanks, semicolons, commas, or an equal sign. A 
carriage return is not allowed within the parameter 
def inition. 


@ An equal sign (=) (by default) marks the keyword. This equal 
sign can be altered (via the SET KEYOPERATOR command) to one 
of six other characters. Therefore, if you want to define a 
parameter with an equal sign in it the equal sign must be 
delimited by single or double quotes or the key operator must 
be changed to a character other than the equal sign. 


e A keyword must never be followed by a positional parameter. 
All positional parameters must be passed first in the CSS 


call, then all keywords may follow. Positional parameters and 
keywords must be separated with commas. 


Examples: 


These are valid examples of CSS calls using positional parameters 
and keywords: 


TEST ABC.FTN, ,BA,OP=BATCH, LI=CON: 
TEST SOURCE=ABC.FTN,LI=CON: 
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These are example 
parameters and keyw 


ILLEGAL CSS 


TEST A,B,FTNOPT 


s of illegal CSS calls using positional 
ords: 


CALLS REASON 


ION=HOLL keyword is greater than 8 characters 


TEST A,B,OP=HOLL,D positional parameter D is after a 


TEST B, ,OP=LNCT 
TEST B, ,=HOLL 
TEST A‘'='B,C'=D 


6.4.1. Referencing 
Within a CSS file, 


of the @= symbol 
parameters. 


Format: 


[efe...é]]e-/Lx 


Parameters: 


keyword 
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keyword 

=60 double equal signs not valid 
Keyword name missing 
second quote not matched 


Keywords Within the CSS 


a keyword parameter is referenced by the use 
(similar to the @ symbol usage for positional 


eyword |/ 


is the symbol which notifies the preprocessor 
that a reference to a keyword parameter is 
being made. The use of additional @ symbols 
is allowed to access keywords of a higher 
level CSS (same as with positional 
parameters). 


is a l1l- to 8-character keyword (excluding 


period). The user has the option to define a 
minimum set of required characters for a 
keyword. This is accomplished by separating 
the required characters and the optional 


characters with a period. Required characters 
precede the period; optional characters follow 
the period. 


For example, defining a keyword in the 
following manner: 


@=/OP .TION/ 


indicates 


@ the Keyword is OPTION, and 


e the minimum required character set to 
reference OPTION is OP. 


Functional Details: 


If the same keyword mnemonic is passed more than once in a CSS 
call, the first keyword match found is used in substitution 
(scanning from left to right in the call). 


References to non-existing Keywords or to higher CSS levels which 
do not exist are not expanded, as well as references without a 
keyword. References with a keyword expand in the usual manner. 
The following examples show the result of putting keyword 
references in a CSS file and then passing Keyword parameters in 
the CSS call. 


Examples: 


CSS file with Keyword references: 


BUILD TEST 
$WR [@=/OP.TION/][(@=/LI.ST/][@=//) 
SEX 
ENDB 


Some calls to the CSS TEST and the results of these calls: 


CALL RESULT 
TEST >» €) €) C] 
TEST A, LIST=PR: POL) CP Rey, f 
TEST OPTION=AA,OP=BB,LI=CON: > [AA] [CON:] [] 
TEST A, OP=LNCT'='62,LIST="AB'@'" [LNCT=62](AB'e'] [] 
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Note that in example 3 the first keyword definition for OPTION 
(AA) is used even though OP=BB is7 specified. Note also in 
example 4 that an equal sign can be passed as part of the keyword 
value as long as it is bracketed with single or double quotes. 
Single quotes can also be passed as part of the keyword value as 
long as they are bracketed by double quotes and vice-versa. 


6.5 USE OF VARIABLES 


MTM and batch users can allocate a specified number of variables 
to be used within a CSS. In general there are two types of 
variables, variables that exist from signon to signoff and 
variables that only exist within a particular CSS level while the 
CSS is active. There are now further distinctions between the 
types of variables available with MTM. 


6.5.1 Types of Variables 


There are now four types of variables within MTM: 


@e Global variables 
@ [Local variables 
@e New global variables 


@® New internal variables 


The first two types - global and local variables - should be 
familiar to all users of previous releases of MTM. Global 
variables exist from signon to signoff or until they are _ freed 
via the $FREE command. Local variables can be used only within 
the CSS levels in which they are defined. When a particular CSS 
level is exited, all local variables defined within it are freed. 


The maximum number of global and local variables that can be 
defined is established at MTM sysgen time. See the 0S/32 
Multi-Terminal Monitor (MTM) System Planning and Operator 
Reference Manual. 


The third and fourth variable types - new global and new internal 
- are new with this release of MTM. These variables are similar 
to the local and global variables in terms of usage. However, 
the way in which they are defined, released, and the capabilities 
available when defining these variables make them much more 
powerful and flexible than the previous variables. 
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New global variables exist from signon through signoff or until 
they are released via the $RELEASE command or if defined by the 
$DEFINE command as an undefined value. The number of new global 
variables allowed in a system is determined at MT sysgen 
(maximum of 99). No new’global variables are allowed in the 
system if the new global option is disabled at MTM sysgen. 


New internal variables exist only within the CSS level in which 


they are def ined. New internal variables are released 
automatically on return to the console level. The user may 
release new internal variables via the $RELEASE command or by 
using an undefined value via a §$DEFINE command. The maximum 


number of new internal variables that can be used is set at MIM 
sysgen time. The maximum/limit allowed is 99. 
NOTE 


Users should familiarize themselves with 
usage of both new global and new internal 


variables. These variable types will 
eventually replace the local or global 
variables usage. Local and global 
variable support will eventually be 


phased out in future releases. 


6.5.2 Naming Local or Global Variables 


A local or global variable name can consist of l-to 8-characters 
and must be preceded by the commercial @ sign. The character 
following the @ sign must be alphabetic (A-Z); the remaining 
characters can be alphanumeric. 


Examples: 


eA 
@B19 
@ABCD1234 


Local variables are named via the $LOCAL command. GLOBAL 
variables are named via the $GLOBAL command. 

6.5.3 Naming New Global or New Internal Variables 

A new global or new internal variable name can consist of 1- to 


8-characters. The first character must be alphabetic, the 
remaining characters can be alphanumeric. 
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Examples: 


GD 
SS12 
$1234567 


New global and new internal variables are named via the $DEFINE 
command and at that time are associated with a decimal number. 
The variable can then be referenced by name or number within a 
css. The following conventions apply to the expansion of a new 
global or new internal variable within a CSS: 


To reference the value of a new global or new internal variable, 
the following formats can be used; 


G specifies a reference to a new global variable 


I specifies a reference to a new internal 
variable. This is the default. 


n specifies the number of the variable to be 
referenced 
name specifies the name of the variable 


To obtain the name of a new variable use the following format: 
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ax Nn 
I 
Where: 
G specifies a new global variable. 
I specifies a new internal variable. 
n specifies the number of the variable whose 
name is being requested. 
Examples: 
@*G3 references global variable number 
3. 
@* /VOLUME / references’ the internal variable 
name VOLUME. 
@*N3 references the name of internal 


variable number 3. 


6.5.4 CSS Line Expansion 

The MTM preprocessor expands the entire CSS line in one step. 
Because of this, the user is advised to be careful when using the 
new global or new internal variable name/value in the CSS line 
after redefining them with a $DEFINE command. 

The following illustrates how the preprocessor handles’ these 
occurrences: 


$DEF INE], ,ST(CORIGINAL) 
$DEF INE1, ,ST(NEW) ; $DEFINE3, ,ST(@*1) 


This expands to: 
$DEFINE1L, ,ST(NEW) ; $DEFINE3, ,ST(ORIGINAL) 


The value of the new internal variable 3 is not the expected 
string NEW, but the string ORIGINAL. 
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6.5.5 Reserved Variables 


Variable names starting with the character string @SYS are 
reserved for system use. A user cannot define variables starting 
with @SYS. However, a user does have read and write access to 
@SYS variables. 


The global variable @SYSCODE is reserved and contains the value 
of the last end of task code for a particular session. 


6.6 COMMANDS EXECUTABLE WITHIN A CSS FILE 


All of the MTM supported commands can be used in acCSS file, as 
well as a number of commands specifically associated with the CSS 
facility. 


Most of the CSS commands start with the §$ character with the 
exception of the SET CODE and PRIOR commands. 


The CSS commands entered within a CSS file are described in the 
following sections. Refer to Appendix E for CSS message 
descriptions. 


NOTE 


If a task is started when CSS is running, 
CSS becomes dormant until the task is 
terminated. Execution of the CSS stream 
will resume after the task terminates. 
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6.6.1 Character Replacement Command $%...% 


The character replacement command (%...%) enables a user to 
define and replace up to four different characters within a 
specified CSS line. The user must indicate the line in which 
replacement is to occur, the new characters, and the characters 
to be replaced. Unless otherwise specified, every occurrence of 
a specified character within the line will be replaced. 


Format: 


char lchar 2, [ char1char2, ...charlchar24] % 
% 
% new delimiter 


Parameters: 


% is the initial current replacement string 
delimiter. This indicates the start of 
the character replacement specification. 


char Lchar 2; is the specification of the character to 

..-charlchar2, be replaced (charl) and the character to 
be used as the replacement (char2). Up 
to four of these replacement 
specifications can be specified. The 
preprocessor translates this statement 
as: replace the character specified by 
charl with the character specified by 
char2. If more than one replacement 
specification is present there must be no 
blanks between them. If charl and char2 
are the same, charl is deleted from the 
CSS line. 


% new delimiter this indicates that a new replacement 
delimiter (by default the % sign) 
follows. The new delimiter is the first 
character after the % sign and is active 
for the remainder of the CSS line (or 
until a new delimiter is specified). 
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Functional Details: 


Character replacement operations are only performed in lines 
which have ae percent sign (%) in column 1 of the line. This 
percent sign (%) is not part of the character replacement 
command , it merely flags lines eligible for character 
replacement. 


Character replacement is only allowed within a CSS. 


The only legal use of blanks within the character replacement 
delimiters is as replacement characters. The initial replacement 
delimiter is always reset to % at the beginning of each CSS line 
and previous replacement characters are deleted. In effect, each 
CSS line with replacement information is treated as a_e single 
entity. 


Each usage of the character replacement command resets all 


previously def ined replacement characters. When a new 
replacement delimiter is specified, all other replacement strings 
are cleared. The $COPY command suppresses the display or 
printing of replacement string delimiters and replacement 
strings. 

NOTE 


Replacing a character with an @ symbol 
will result in an additional 
preprocessing step for that line in order 
to expand the @ symbol with the 
appropriate substitution parameter if 
possible. 


The following examples are used to illustrate the basic 
functionality of the character replacement command. Obviously, 
the uses of this command are not limited to those shown below. 
The command becomes extremely powerful as the user introduces 
more involved substitution and replacement within the same line. 
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em ee eee me ew es ee a ee me ee we ee ee eee ee ee en ee ee ee oe 


CHARACTER REPLACEMENT ' H RESULT AFTER 
' 


—— oe 


CSS LINE | INTERPRETATION i PROCESS ING 
| PP SPSS SSSR Ee ST SAE ETE SO SAT SSR SSSA SPSS TTS SS SS SSSA RANTS AV Se Lee Se ET ES 


t 
(') with the comma (,) in the i 
string F7D‘'20. H 
| Change the replacement delimiter H 
| from % to the \, and replace the | 
i single quote character (') with H 
i] i 
1 4 
i i 


H 
t 
i] 
4 
] 
%LO %',%F7D'20 | Replace the single quote character ; >LO F7D,20 | 
] 
! 
8 


the comma (,) in the string 
F7D'20. 


| Replace the single quote character j} 
! (') with a comma (,) replace A H 
i with 2, replace B with a 0 in the jj} 
{ character string 'AB. The string | 
i F7D remains unchanged. i 


$LO %',%F7D'20;%%$$W'A', | Replace the single quote character |} 
| with the comma character in the H 
| string F7D'20. Then reset the H 
i line (clear all replacement i 
{i instructions for the balance of H 
i the line). Because of this the i 
i single quotes around A are not H 
| replaced. | 


Hy 
i 
>LO F7D,20;$W'A' | 
' 
' 
' 
{ 
i 


Another use of the character replacement command is the 
combination of character replacement and parameter substitution. 


Example: 


$BUILD TEST 


“SE\\XO\SE$+tERSSWR @1 
$EX 
$ENDB 


This example will result in three preprocessing passes through 
the Line in order to complete the requested functions. A step by 
step analysis will show this. Assume TEST CSS is called with the 
following call: 


TEST *2,+3,'3RD USED' 


The first preprocessing pass through the line causes the command 
delimiter to be changed from % to \, the first parameter in the 
CSS call (*2) replaces the @ 1 reference in the CSS, and the * is 
replaced with an @ symbol. The line now looks like this: 


SStOSSWR @2 
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The replace to an @ sign requires a second preprocessor pass 
through the line in order to expand the reference. On the second 
preprocessing pass through the Line, the second parameter in the 
CSS call (+3) replaces the @2 reference in the CSS line, and then 
the + is replaced by an @ symbol according to the_- second 
character replacement specificaion. The line now looks like 
this: 


$WR @3 


The replace to an @ sign reference requires a third preprocessor 
pass through the line in order to expand the parameter reference. 
On this pass the third parameter in the CSS call (3RD USED) is 
substituted for the @3 reference within the CSS. The line now 
looks like this: 


$WR 3RD USED 


No further preprocessing of the line is required. The final 
output of this CSS when called as detailed previously would be: 


-3RD USED 
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6.6.2 $BUILD and $ENDB Commands 


The $BUILD command causes succeeding lines to be copied to a 


specified file 


command. 
performed. 
Format: 
fd 
SBUILD 
Llu 
$ENDB 


Parameters: 


fd 


lu 


APPEND 


up to, but excluding, the corresponding $ENDB 
Before each line is copied, parameter substitution is 


[, APPEND | 


is the output file. If fd does not exist, an 
indexed file is allocated with a logical 
record length equal to the command buffer 
length. If the fd specified does not contain 
an extension, .CSS is the default. If a blank 
extension is desired, the period following the 
filename must be specified. 


specifies that a temporary file is to be 
created and the $BUILD data is copied to it. 
When $ENDB is encountered, the file is 
assigned to the specified logical unit of the 
loaded task. The lu option is valid only when 
a task is loaded. 


allows the user to add data to an existing fd. 
If the fd does not exist, it is allocated. 
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Functional Details: 


The $BUILD command must be the last command on its input line. 
Any further information on the Line is treated as a comment and 
is not copied to the file. 


The $ENDB command must be the first command in the command Line, 
but it meed not start in column 1. Other commands can follow 
$ENDB on the command line, but nesting of $BUILD and $ENDB is not 
permitted. 
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6.6.3 $§CLEAR Command 


The $CLEAR command terminates a CSS stream, closes all CSS files, 
and deactivates CSS. 
Format: 

SCLEAR 


Functional Details: 


The $CLEAR command can be entered in command mode, task loaded 
mode, and task executing mode. 
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6.6.4 $CONTINUE Command 
The $CONTINUE command resumes execution of a CSS _ procedure 
suspended by a $PAUSE or $WAIT command. 


Format: 


SCONT INUE 
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{ §COPY AND 
$NOCOPY 


6.6.5 §COPY and $NOCOPY Commands 


The $COPY and §$NOCOPY commands control the listing of css 


commands on the terminal or log device (if from batch). $COPY 
initiates the Listing and all subsequent commands are copied to 
the terminal before being executed. The $NOCOPY command 


deactivates the listing, but is itself listed. The $COPY command 
is an aid in debugging CSS job streams. 


Format: 


SCOPY 
SNOCOPY 
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6.6.6 $DEFINE Command 


The $DEFINE command is used to define or to redefine new global 
or new internal variables. 


Format: 
SDEF INE , 


Parameters: 


GVARIABLE 


IVARTIABLE 


name 


operator, 
operator. 
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GVARIABLE 


*},fhanc] operator, Loperator, ...operatorp] 


specifies that a new global variable is being 
defined. (not allowed if new global option is 
set off at MTM sysgen). 


specifies that a new internal variable is 
being defined. This is the default. 


is the new variable number. The allowed range 
is between 1 and the maximum value set at MIM 
sysgen. 


is the new global variable or new internal 
variable name. It is 1- to 8-characters long 
and can consist of any character A - Zor any 
number O - 9. 


- operatorn 


is one or more of the following operators 
which selects a particular function to be 
performed to determine the variable's value. 


File Descriptor Operators 


ACCOUNT 

F I LENAME 
EXTENS ION 
VOLUMENAME 
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Logical Operators 


LOGICAL GO 
LOGICAL LD 
LOGICAL LU 
LOGICAL TD 
LOGICAL TU 


Computation and Conversion Operators 


DCOMPUTE 
DHCONVERT 
HCOMPUTE 
HDCONVERT 


Other Operators 


CLEAR 
CURRENT 
DVOLUMENAME 
REQUIRED 
SEARCH 
STRING 


The following sections define the format and function of each of 
these operators within the $DEFINE command. 


6.6.6.1 File Descriptor Operators 

The following four operators can be used to determine the 
account, filename, extension, or volumename of a specified file 
descriptor and then assign the determined portion of the fd as 
the value of the variable being defined. 

6.6.6.1.1 ACCOUNT Operator 

The ACCOUNT operator of the $DEFINE command enables a user. to 
determine the account designator of a specified file descriptor 


and assign the designator as the value of the variable heing 
def ined. 


Format: 


fd 
ACCOUNT 
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Parameters: 


fa is the file descriptor of the file or device 
for which the account designator is to be 
determined. 


= specifies that the current total result for 


this $DEFINE command is used to determine the 
account designator. 


Functional Details: 


The value returned is /P, /G, or /S depending upon the specified 
account. If no account is specified, /P is returned for 
filenames and undefined is returned for devices. If the user has 
the account number privilege, the account number, rather than an 
account class, is returned. 


Example: 
The following CSS is built: 


$BUILD TEST 

$DEFINE 6, ,ACCOUNT (@1) 
$WR @*6 

$EX 

$ENDB 


The above CSS is called with the euaienind call: 
TEST ABC.FTN/G 
The result of $WR @*6 is: 
/G 
6.6.6.1.2 EXTENSION Operator 
The EXTENSION operator of the $DEFINE command enables the user to 


determine the extension of a given file descriptor and return 
that extension as the value of the variable being defined. 


48-043 FOO RO1 6-25 


Format: 


fd 
EXTENS ION 


Parameters: 


fd is the file descriptor of the file or device 
for which the extension is to be determined. 

= the current total result for this $DEFINE 
command is used to determine the extension. 


Functional Details: 


The returned value will contain a leading period if an extension 
was specified, otherwise the value of the variable is undefined. 


Example: 


BUILD TEST 

$DEFINE 10, ,EXTENSION(@1) 
$WR @*10 

$EX 

ENDB 


When called with the following CSS call: 
TEST FORTRAN .FTN 
The $WR @*10 would output .FTN 
6.6.6.1.3 FILENAME Operator 
The FILENAME operator of the $DEFINE command enables the user to 


determine the filename of a given file descriptor and return that 
value as the defined variable. 
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Format: 


renne({) 


Parameters: 


fd is the file descriptor of the file or device 
for which the filename is to be determined. 
= the current total result for this $DEFINE 
command is used to determine the filename. 
Functional Details: 
If a file descriptor was specified in the FILENAME operator, the 
returned value is the filename. 
If a device name was specified in the FILENAME operator, the 
returned value is undefined. 


Example: 


BUILD TEST 

$DEFINE 10,,FILENAME(@1) 
$WR @*10 

$EXIT 

ENDB 


When called with the following CSS call: 
TEST M301:TCHFIN12.FTN 


the $WR @*10 result is TCHFIN1L2 
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6.6.6.1.4 VOLUMENAME Operator 


The VOLUMENAME operator of the $DEFINE command enables the user 
to determine the volume name of a given file descriptor and 
assign that value to the variable being defined. 


Format: 


fd 
YOLUMENAME 


— 
= 


Parameters: 
fd is a file descriptor of the file for which the 
volumename is to be determined. 
= the current total result for this §$DEFINE is 
used to determine the volumename. 


Functional Details: 


The new variable value returned is the specified volume name, or 
the user's private volume name under MTM. The volume name is 
always followed by a colon (:). 


Example: 


BUILD TEST.CSS 

$DEFINE 20,, VOLUMENAME (M301:SOURCE.FTN) 
$WR @*20 

$EX 

ENDB 


Calling the above CSS with the following call: 
*TEST 
The value of $WR @*20 is: 


-M301: 
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6.6.6.2 LOGICAL Operators 


The LOGICAL operators of the $DEFINE command enable the user to 
test the current or last result as defined, exit from the $DEFINE 
command, or skip operators within the §$DEFINE command. 


Format: 


LO} Neoael 
ad Sonal 


Parameters: 

GO specifies an unconditional skip of operators 
or an exit from within the $DEFINE command. 

n is a decimal number between O and 999. 

Where: 
O = exit the $DEFINE command. 
1-999 = skip this number of operators 

L specifies that the result of the last operator 
is to be tested. The test performed depends 
upon whether the D or U option follows. 

T the current total result of the $DEF INE 
command is tested. The test performed depends 
upon whether the D or U option follows. 

D tests to see if the result specified by the L 
or T parameters is defined. 

U tests to see if the result specified by the L 
or T parameters is undefined. 

$name is a name defined via the $LABEL command. If 


a skip is specified, the skip will be done to 
this label. 
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Example: 


BUILD TEST.CSS 

$DEFINE 5,, ST (@1) EXT (=) LU2 CL(L) GOO ST(.FTN) 
SWR @*5 

$EX 

ENDB 


This $DEFINE command perfoms a check to see if the first 
positional parameter in the CSS call contains a filename 
extension. If it does, the following two operations are 
performed to clear the result of the EXT operator and the $DEFINE 
is exited. 


If no filename extension is specified the following two operators 
are skipped and an extension is attached. 


6.6.6.3 Computation and Conversion Operators 

ay 
The computation and conversion operators are used to perform 
decimal or hexadecimal computation and decimal to hexadecimal (or 
vice-versa) conversion, and then assign the result as the value 
of the variable specified in the $DEFINE command. 


6.6.6.3.1 DCOMPUTE Operator 
The DCOMPUTE operator of the $DEFINE command is used to perform 


decimal computation within a CSS line. The computed value then 
becomes the value of the variable defined in the $DEFINE command. 


Format: 


Parameters: 

#digits specifies the number of digits for the decimal 
result with leading zeros and including the 
sign column (+t or -). If not specified the 
default number of digits used (including sign) 
is 4. 

operand is the operand (in decimal) with optional sign 
(+ or -). The range is absolute up to 


Y'OFFFFFFF'. 
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operator is the computational operator: 


+ (addition) 

= (subtraction) 

bs (multiplication) 
/ (division) 


Functional Details: 


The maximum value allowed for an operand or a result is absolute 
Y'OFFFFFFF'. Values outside this range generate the following 
message. 


DEF6-ERR 


Mathematical computation is performed from left to right, and the 
intermediate result is combined with the next operator and _ the 
following operand. Computation is performed according to the 
fixed point integer rules of rounding. 


Examples: 
$DEFINE 7, ,DCOMPUTE (-33) 


-033 becomes the value of variable 7(@*7). The default number of 
Gigits (4) is used. 


$DEFINE 4,,DCOMPUTE (6,-2+5/-2*4) 


-00004 becomes the value of variable 4 (@*4). The number of 
digits in the result is defined as 6. 


$DEFINE 5, ,DC(@*4*@*7+100) 


+232 becomes the value of variable 5(@*5). This is determined by 
multiplying the value of variable 4 (@*4), which is defined 
above, as -4 with the value of variable 7(@*7), which is defined 
as -33 above then adding 100 to the result. The default number 
of digits (4) is used. 
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6.6.6.3.2 DHCONVERT Operator 


The DHCONVERT operator of the $DEFINE command is used to perform 
decimal computation and then convert the result to hexadecimal. 
This hexadecimal result is then assigned as the value of the 
variable specified in the $DEFINE command. 


Format: 


digits 


# 
DHCONVERT 


Parameters: 

#digits specifies the number of digits for the 
hexadecimal result with. leading zeros’ and 
excluding the sign designator. If not 
specified the default number of digits is 4. 

operand is the operand (in decimal). Negative numbers 
are not allowed. The range is absolute up to 
Y'OFFFFFFF'‘. 

operator is the computational operator: 


+ (addition) 

= (subtraction) 

x (multiplication) 
/ (division) 


Functional Details: 


The maximum value allowed for an operand or a result is absolute 
Y'OFFFFFFF'. Values outside this maximum generate the following 
message: 


DEF 7~-ERR 


Mathematical computation is performed from left to right and the 
immediate result is combined with the next operator and the 
following operand. Computation is performed according to the 
fixed point integer rules of rounding. 
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\ operand, [[eperator, operand, ] [operatorpnoperandn]]| 


\ 


Examples: 


$DEFINE 7, , DHCONVERT(-33) the value of variable 


7(@*7) becomes hexadecimal 
0021. 


$DEFINE 4, , DHCONVERT(6,-2+5/-2*-4) the value of variable 


4(@*4) becomes a 
hexadecimal 000004. 


$DEFINE 5, ,DHCONVERT(4*@*7+100) the value of variable 5 


becomes a hexadecimal 
OOB8. (4x21)+100 = 184 = 
OOB8 in hex. 


6.6.6.3.3 HCOMPUTE Operator 


The HCOMPUTE operator of the $DEFINE command enables a user to 
perform hexadecimal computation within the $DEFINE command and 
return the result as the defined variables value. 


Format: 


#tdigits 
HCOMPUTE 


Parameters: 


#digits 


operand 


operator 
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defines the number of digits for the 
hexadecimal result with leading zeros. If not 
specified the default number of digits is 4. 


is an operand in hexadecimal without sign (all 
values are assumed positive), the maximum 
value being absolute up to Y'OFFFFFFF'. 


is one of the following mathematical 
operators: 


+ (addition) 

- (subtraction) 

“i (multiplication) 
/ (division) 


\ operand, [[eperator, operand,] [bperatorpoperandn]| 


Functional Details: 


The range allowed for an operand or a result is up to absolute 
Y'OFFFFFFF' otherwise the following message is generated: 


DEF6-ERR 


If the hexadecimal result is negative, the following message is 
generated: 


DEF 7-ERR 


Computation within an HCOMPUTE operator is from left to right; 
the intermediate result is combined with the next operator and 
the following operand. 


Examples: 


$DEFINE 7, ,HCOMPUTE (AEO) @*7 = OAEO 


$DEFINE 4, ,HCOMPUTE(6,CO/20+18) @*4 = OOOOILE 


6.6.6.3.4 HDCONVERT Operator 


The HDCONVERT operator of the $DEFINE command enables the user to 
perform hexadecimal computation within a $DEFINE command. The 
result is converted to decimal and is returned as the value of 
the defined variable. 


Format: 


#digits 
HDCONVERT f | operandg [[eperator, operand, | [peratorpoperandn || 


ape 


Parameters: 


#tdigits specifies the number of digits for the decimal 
result with leading zeros and the sign (+ or 
ae ae If not specified the default number of 
digits is 4. 
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operand — is a hexadecimal operand without’ sign. The 
maximum value allowed is absolute Y'OFFFFFFF'. 


operator is one of the following mathematical 
operators: 
+ (addition) 
= (subtraction) 
* (multiplication) 
/ (division) 


Functional Details: 


The maximum allowable value for an operand or a result is 
absolute Y'OFFFFFFF'. Values greater than the maximum will 
generate the following message: 


DEF6-ERR 


A negative hexadecimal operand will generate the following 
message: 


DEF7-ERR 


Computation within the HDCONVERT operator is from left to right, 
and the intermediate result is always combined with the next 
operator and the following operand. 


Examples: 
$DEFINE 7,,HDCONVERT(AO) @*7 = +160 
$DEFINE 4, ,HDCONVERT(6,CO/20+18) a*4 = +00030 


6.6.6.4 Other Operators 


The following sections detail various miscellaneous operators for 
the $DEFINE command. 
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en meee cme woe 


6.6.6.4.1 CLEAR Operator 


The CLEAR operator of the $DEFINE command enables the user _ to 
clear the current total result or the last result determined in 
the $DEFINE command. 


Format: 
lo 
CLEAR 
T 
Parameters: 
L specifies that the last result determined is 
to be reset. 
aig the current total result is to be reset. 


Functional Details: 


Use of the CLEAR (L) form of this operator resets the last 
result, even if a skip was performed. The last result depends on 
the value the last operator (except logical operators) 
determined. 


Example: 


The following is an example of how to add the default extension 
-.FTN to a file descriptor. The file descriptor passed in the CSS 
call is allowed with or without an extension. 


BUILD TEST.CSS 

$DEFINE 5,,ST(@l) EXT (=) LU2 <L(L) GO 0 ST(.FTN) 
$WR @*5 

$EX 

ENDB 


This example CSS tests to see if an extension is included in the 
CSS call. If an extension is specified it is not changed. If no 
extension is specified, the default extension .FTN is added. If 
this CSS was called with the following: 


TEST SYS:ABC the result @*5 
TEST BBBB. XYZ the result @*5 


SYS:ABC.FTN 
BBBB. XYZ 
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6.6.6.4.2 CURRENT 


Operator 


The CURRENT operator of the $DEFINE command is used to determine 
current information within the user's environment and to assign 


that information as 


Format: 


the value of the variable being defined. 


BATCH 

DATE 

EQT 
CURRENT GROUP 

INTERACTIVE 

PRIVATE 

TIME 

USERNAME 

Parameters: 

BATCH in batch mode the value returned is the batch 
job file descriptor; in interactive mode the 
value is undefined. 

DATE the value returned is the current date in the 
format MM/DD/YY or DD/MM/YY depending on the 
format selected at OS/32 system generation. 

EOT the value returned is the last end of task 
code generated. A maximum of four digits is 
allowed. Leading zeros are dropped. 

GROUP the value returned is the 5 digit current 
group account number with leading zeros. 

INTERACTIVE in interactive mode the value returned is’ the 
interactive device name, in batch mode the 
value is undefined. 

PRIVATE the value returned is the 5 digit current 
private account number with leading zeros. 

TIME causes the current time (HH:MM:SS) to be 
returned. 

USERNAME causes the current username to be returned. 
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Example: 


BUILD TIME.CSS 

$DEFINE 5, ,CURRENT(TIME) 
$WR @*5 

$EX 

ENDB 


Execution of this CSS will cause the current time to be written 
as @*5. 


6.6.6.4.3 DVOLUMENAME Operator 


The DVOLUMENAME operator of the $DEFINE command enables the user 
to determine default volume names such as SYSTEM volume, SPOOL 
volume, etc. and assign the name as the value of the defined 
variable. 


Format: 
PRIVATE 
ROLL 
DVOLUMENAME SPOOL 
SYSTEM 
TEMP 
Parameters: 
PRIVATE returns the volume name of the users'7 default 
volume. 
ROT. L returns the volume name of the ROLL volume. 
SPOOL returns the volume name of the SPOOL volume. 
SYSTEM returns the volume name of the SYSTEM volume. 
TEMP returns the volume name of the TEMP volume. 


Functional Details: 


The volume name returned is always followed by a colon (:). 
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Examples: 


Assume that volume SCRT/TEMP has been set at the system console. 


$DEFINE 6, TEMPVOL, DVOLUMENAME (TEMP ) 


$WR @*6 reference by variable would return 
SCRT: 
S$WR @*/TEMPVOL/ reference by variable name would 


also return SCRT: 


6.6.6.4.4 REQUIRED Operator 


The REQUIRED operator of the $§DEFINE command enables a user to 
Gesignate a new internal variable as required; that is, the 
variable must have a defined value. If the new internal variable 
designated as REQUIRED is not defined within the CSS, execution 
of the CSS is paused and the user is prompted at the user's MIM 
console to supply a definition for the required variable. 


Format: 


REQUIRED [( [name]) | 


Parameters: 


name is an optional 1- to 8-character name for’ the 
required new internal variable that MTM will 
use when the user is prompted at the user's 
MIM terminal. This mame may be composed of 
any of the letters A through Z. 


Functional Details: 


The REQUIRED operator must be the last operator in a §$DEFINE 
command. All blanks between the parentheses and between the name 
are dropped. 


48-043 FOO RO1l 6-39 


The name for the required new internal variable that is displayed 
to the user console is one of the following (in order of 
precedence): 


e The name specified in the name field of the REQUIRED operator, 
e The name used in the $DEFINE command, or 


@ The number specified in the $DEFINE command. 


Examples: 


BUILD TEST.CSS 

$DEFINE 3,LLISTDEV, REQUIRED 

$DEFINE 4,OPTION, REQUIRED (NEWNAME ) 
$DEFINE 5, ,REQUIRED 

$EXIT 

ENDB 


The above CSS identifies three new internal variables (3, 4, and 
5) as required variables. If this CSS is called as follows, the 
following message prompts will be issued at the users console: 


*TEST CSS call without parameters 

-GIVE LISTDEV= Prompt for the first required variable, 
the variable name is used in the name 
field 

-GIVE NEWNAME= Prompt for second required variable, the 
name in REQUIRED field is used 

-GIVE IVAR 005= Prompt for third required variable, the 


variable number is used 


6.6.6.4.5 SEARCH Operator 

The SEARCH operator of the $DEFINE command enables the user _ to 
perform string searches for matches with specified Keywords 
passed in the CSS call. On each match found, the string 


(including the Keyword) is moved to the value of the new variable 
defined in the $DEFINE command. 


Format: 


‘d2' 
SEARCH delimiter, | [aeroes ['keyword, We ae "keywordn] | ; [str ing, [ae str ing2]| delimiter, 
‘ay + : 
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Parameters: 


delimiter, 


[es skeywordy] 


es 
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~ is one of the following character pairs used 


to delimit the SEARCH operator specifications: 


delimiter, ...delimiter, = #... # 
+ 


The character pair chosen as the specification 
delimiter must not appear in the SEARCH 
operator specifications or as a string 
Gelimiter (do). 


is the string delimiter which is used to 
separate the strings to be searched. The 
string delimiter may be any character except 
carriage return or semicolon. If the ‘d,' 
option is used, the delimiter (d,) following 
the matched string is not included when the 
string is moved, if the ‘dy ot delimiter is 
used, the delimiter (d 5) is included when the 
string is moved. 


is a 1l- to 8- character (A through Z) Keyword. 
A keyword specification can be further defined 
to show the minimum number of characters’) that 
can be used to reference the keyword. This is 
accomplished by separating the required 
characters of the keyword and the optional 
characters of the keyword with a period. For 
example: 


OP.TION 


The keyword name is OPTION but a call 
specifying OP= will reference this Keyword. 
Multiple keywords may be defined in a SEARCH 
operator, all strings are searched for matches 
with each defined keyword. Multiple keywords 
are separated by a ' mark. 


is a character string which may contain 
any character except carriage return or 
semicolon. Null strings are allowed. The 
specified string is searched for any matches 
with keywords. If a positional parameter 
reference is specified (@l, @2) the string to 
be searched can be passed in the CSS call. 


Functional Details: 


The beginning of a string is tested for a match with the 
specified keywords. The search for a match begins with the first 
string. If one of the defined keywords matches a string entry, 
this string is moved to the new variable's value. The move 
includes leading blanks, the keyword, and all following 
characters up to the next string delimiter (d,) or including the 
string delimiter if the ‘dot delimiter was specified. This 
process is repeated for each string to be searched. For example: 


If the keyword is: 


OPTION 


and the string delimiter (d,) is: 


Le 


and the string to be searched is: 


..-# OPT = HOLL BATCH # ... 


the new variable being defined has a value of: 


OPT = HOLL BATCH 


Examples: 


BUILD TEST.CSS 

$DEF 5,,SEARCH('#',OP.TION'BA.TCH, @1) 
$WR @*5 

$EX 

ENDB 


The above CSS identifies the pound sign as the string delimiter; 
keywords are OP.TION and BA.TCH; the string to be searched is @1, 
the first parameter passed in the CSS call. 


When calling the above CSS with the following call: 


TEST OP/AAAA# BATCH # SOURCE 
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The first string searched is OP/AAAA. A match with the first 
keyword is found OP.TION. OP/AAAA is moved to the variables 
value. : 

The next string searched is BATCH. A match with the second 
keyword is found BA.TCH. BATCH is moved to the variables value. 
next string searched is SOURCE. No match is found. 

The subsequent value of $WR @*5 is OP/AAAA BATCH 


If calling TEST.CSS with the following: 
TEST xx # BATCH # BA/AAA # YY # OPTI 


The first string searched (xx) has no match. The second. string 
searched (BATCH) matches a keyword. The third string seached 
(BA/AAA) matches a keyword. The fourth string (YY) has no match. 
The fifth string searched (OPTI) matches a keyword. 

The subsequent value of $WR @*5 = BATCH BA/AAA OPTI 

6.6.6.4.6 STRING Operator 

The STRING operator of the $DEFINE command enables the value of 
the new variable being defined to be a user specified string. 
Format: 


STRING delimiter, string delimiter, | ...delimitern string delimitern| 


Parameters: 


delimiter is any of the following characters that 
delimits the beginning and end of the string: 


eneee 


The character used as the delimiter should 
never appear within the string. 
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string 


Example: 


BUILD TEST 


is a character string which may contain any 
characters except carriage return or the 
Gelimiter character. This string becomes’ the 
value of the new variable being defined in the 
$DEF INE command. Leading and/or trailing 
blanks are included. 


$DEFINE 7,, STRING (ABC) ST # A ($$) A# 


$WR [@*7] 
$EX 
ENDB 


Calling the above CSS with the following call: 


*TEST 


The resulting output of the $WR @*7 statement is: 


[ABC A ($$) A] 
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6.6.7 $EXIT Command 


The $EXIT command terminates a CSS procedure. Control is 
returned to the calling CSS procedure or the terminal if the CSS 
procedure was called from the terminal. All commands on the 


lines after the $EXIT command are ignored. 


Format: 


SEXIT 
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6.6.8 §$FREE Command 


The $FREE command frees one or more local or global variables. 
This command has no effect on new global or new internal 
variables. 


Format: 
$FREE varname;, [,---,Vvarnamen] 
Parameters: 


varname is a l- to 8-character name specifying the 
variable whose name and value are to be freed. 


Example: 


$FREE @A 
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6.6.9 §GLOBAL Command 
The $GLOBAL command names a global variable and specifies the 


maximum length of the variable to which it can be set by the §SET 
command. 


Format: 


Length length 
$GLOBAL varname - ree, varname = 


Parameters: 


varname is a 1l- to 8-character name _ (the first 
character is alphabétic) preceded by the @ 
sign, identifying a global variable. 


length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the $SET command. If this parameter is 


omitted, the default is 8. 


Example: 


$GLOBAL @A(6) 
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$JOB AND 


6.6.10 $J0B and $TERMJOB Commands 


The $JOB and $TERMJOB commands set the boundaries of a 


CSS 


job. 


The $J0B command indicates the start, and the $TERMJOB command 
indicates the end of a CSS job that contains all the user CSS 
commands. 
Format: 
SJOB 
CPUTIME=maxt ime 
[class id=iocount,| [,---,elassid-iocounts9| 
STERMJOB 
Parameters: 

CPUTIME= maxtime is a decimal number’ specifying the 
maximum CPU time to which the CSS routine is 
limited. If this parameter is omitted, the 
default established at MTM sysgen is used. If 
O is specified, no limits are applied. 

classid= is one of the 4-character alphanumeric 
mnemonics specified at MTM sysgen that is 
associated with each specified device or file 
class. 

iocount is a decimal number specifying the maximum 


number of I/0 transfers to which the CSS 


routine is Limited for that class. 


If 


this 


parameter is omitted, the default established 
at sysgen time is used. If O is specified, no 


limits are applied to that class. 
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Functional Details: 


The $JOB and §$TERMJOB commands are not necessary in a CSS 
procedure. However, they help prevent errors in one CSS job from 
affecting other CSS jobs. If a CSS job contains an error, the 
statements remaining in that job are skipped until a $TERMJOB 
command is found. The next command executed is the first command 
found after a §$TERMJOB command. If the next command is a $JOB 
command signifying the start of a new CSS job, it could be 
skipped because the system is looking for a $TERMJOB that 
signifies the end of the CSS job containing the error. 


The CSS job containing an error is aborted, and the end of task 
code is 255. The $JOB command resets the end of task code to 0 
for the next CSS job. 


Interactive jobs have no default limits established at sysgen 
time. However, the user can specify CPU time and I/0 transfer 
limits for a particular job through the $JOB command. 


Any Limits in the $JOB command found in a batch stream are 
ignored if limits were already specified in the SIGNON command. 
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6.6.11 $LOCAL Command 


The $LOCAL command names a local variable and specifies the 
maximum length variable to which it can be set by the $SET 


command. 


Format: 


Parameters: 


varname 


length 


Example: 


$I_LOCAL @A(4) 


is a 1- to 8-character name (the first 
character is alphabetic) preceded by the @ 
sign, identifying a local variable. 


is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the $SET command. If this parameter is 
omitted, the default is 8. 
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6.6.12 §PAUSE Command 


The $PAUSE command suspends execution of a CSS procedure. 


Format: 


SPAUSE 


Functional Details: 


When $PAUSE is entered, the CSS procedure remains suspended until 
the $CONTINUE command is entered or the $CLEAR command is entered 
to terminate a procedure suspended by a $PAUSE. 
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6.6.13 PRIOR Command 


Tne PRIOR command is used in CSS files to set the priority for a 
subsequently loaded task. This command is available in CSS files 
from the system account and from privileged users of MTM (to 
raise or lower the priority of a susbsequently loaded task) and 
to nonprivileged MTM users (to lower the priority of a 
subsequently loaded task relative to the user's MTM priority.) 
However, nonprivileged users of MTM cannot use the PRIOR command 
to raise the priority of a task above their MTM priority. 


Format: 


PRIOR n 


Parameter: 


n is a decimal number specifying the priority of 
the susbsequently loaded task relative to the 
priority of MTM. hn may range from 1 through 
255 when the PRIOR command is in a CSS file 
from the system account or from a privileged 
user. mn may range from 12 through 255 when 
the PRIOR command is in aCSS file froma 
nonprivileged MTM user. 


Functional Details: 


The PRIOR command can be entered from CSS files. only. If the 
task loaded subsequent to a PRIOR command generates a load error 
or goes to end of task, the priority specified in the PRIOR 
command is reset to the default MTM priority. 


If an invalid priority number is specified in a PRIOR’ command 
(i.e. 1-11 by a nonprivileged user), the invalid priority 
specification is ignored, no message is generated, and the 
Gefault MTM priority is used. 
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6.6.14 $RELEASE Command 


The $RELEASE command is used to release a new global or new 
internal variable from its current value and delete the released 
variable's associated buffer. This command has no effect on 
local or global variables. 


Format: 
n,/Np2 
GVARIABLE - 
’ ny re rDn 


SRELEASE 
IVARIABLE 


Parameters: 


GVARIABI.E indicates that the variables to be released 
are new global variables. 

IVARIABLE indicates that the variables to be released 
are new internal variables. 

n,/No2 indicates that all variables (of the type 
selected via the preceding parameter) between 
the range n;/np, be released. Where n is a 


decimal number between 1 and the maximum value 
allowed at MTM sysgen for the _ specified 
variable type. 


Ny---Nn n is a decimal number of a variable (either 
new global or new internal) or variables to be 
released. n must be within the range 1 and 


the maximum value allowed at MTM sysgen for 
the specified variable type. 


ALL specifies that all new internal or new global 


variables be released. This is the default if 
no specific variable numbers are specified. 
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Functional Details: 


This command may be entered in command mode, task loaded wmode, 


task executing mode, and CSS mode. In order to reduce buffer 
overhead, variables that are no longer being used should be 
released. If this command is directed to a variable that was 


already released, the command is ignored and no error message _ is 
generated. 


Examples: 
$RELEASE GVARIABLE, 1/5 

All new global variables from 1 through 5 are released. 
$RELEASE IVARIABLE, 16, 19, 18, 25 


The new internal variables numbered 16, 19, 18, and 25 are 
released. 


$RELEASE IVARIABLE, ALL 
All new internal variables are released. 
NOTE 
This command does not release local and 


global variables created with the _ §$SET 
command. 
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6.6.15 $SET Command 


The $SET command establishes the value of a named local or global 
variable. This command has no effect on new global or new 
internal variables. 


Format: 
$SET varname=e 
Parameter: 


varname= e is an expression, variable, or parameter 
established as the value of the variable. 


Functional Details: 


Expressions for this command are concatenations of variables, 


parameters, and character strings. No operators are allowed in 
an expression. If a character string is included in an 
expression, it must be enclosed between apostrophes ('). If an 
apostrophe is part of the character string, it must be 


represented as two apostrophes (''). 


The initial value of the variable is'7 blanks. This allows’7 the 
$IFNULL and $IFNNULL commands to test for a null or not null 
value. 


Examples: 


$SET @A = @A1L@A2 
$SET @A = @l 
$SET @A = ‘'A''B' 
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6.6.16 SET CODE Command 


The SET CODE command modifies the current end of task code. 


Format: 
SET CODE n 


Parameter: 


is a decimal number from 1 through 254. 
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6.6.17 $SKIP Command 


The $SKIP command is used between the $JOB and $TERMJOB commands. 
The $SKIP command indicates that subsequent commands are to _ be 
skipped until a §$TERMJOB command is found. The end of task code 
is set to 255. 


Format: 


SSKIP 
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6.6.18 $WAIT Command 


The $WAIT command suspends execution of a CSS for a_ specified 


period of time. 


The $CONTINUE command can be used to override this command and 


continue the CSS. 


Format: 


Parameter: 


Functional Details: 


is a decimal number from 1 through 900 
specifying the number of seconds CSS execution 
will be suspended. If this parameter is 
omitted, the default is 1 second. 


The $WAIT command will only function from a CSS routine. 


The $CONTINUE command can be used to override this command = and 


continue the CSS. 
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6.6.19 §WRITE Command 
The $WRITE command writes a message to the terminal or log device 
for both interactive and batch ‘jobs. 
Format: 
SWRITE text [; ] 


Functional Details: 


The message is output to the terminal or log device. It begins 
with the first mnonblank character after $WRITE and ends with a 
semicolon or carriage return. The semicolon is not printed. 
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6.7 LOGICAL IF COMMANDS 


The logical IF commands all start with the three characters, §$IF, 
and allow one argument; e.g., $IFE 225, $IFX B.CSS, $IFNULL @1l. 


Each logical IF command establishes a condition that is tested by 
the CSS processor. If the result of this test is true, commands 
up to a corresponding $ELSE or $ENDC command are executed. If 
the result is false, these same commands are skipped. 


The $ENDC command delimits the range of a logical IF; however, 
nesting is permitted so each $IF must have a corresponding $ENDC. 


In the following examples, the ranges of the various logical IF 
commands are indicated by brackets: 


$IF SIF $IF 
$ENDC i ue 
$ENDC $ENDC 
: $IF 
$ENDC ; 
$ENDC 
$ENDC 
There is no restriction on the depth of nesting. Logical IF 


commands are used within a CSS file. However, they differ from 
previous CSS commands in that each one tests a specific built-in, 
defined condition rather than causes a specific action. 


The logical IF commands fall into three categories: 


e End of task code testing 
e File existence testing 


@e Parameter existence testing 
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6.7.1 End of Task Code Testing Commands 


The end of task code is a halfword quantity maintained for each 
user by the system. It is set or reset in any of the following 


ways: 


SET CODE n 


$JOB 


Command error 


SSKIP 


End of task 
(SVC 3,n) 


CANCEL 


This command, which can be included in a CSS 
file or entered at the terminal, sets the end 
of task code to n. 


As part of its start job function, this 
command resets the end of task code for the 
current CSS task to 0. 


A command error causes the CSS mechanism to 
skip to §TERMJOB assuming that a $JOB was 
executed. (If no §$JOB was executed, CSS 
terminates. ) To indicate that the skip took 
place, the end of task code is set to 255. 


This command has the same effect as a command 
error. 


When any task terminates by executing the end 
of task program command (SVC 3,n), the end of 
task code for that task is set to n. 


When a task is cancelled, the end of task code 
is set to 255. 


The six commands available for testing the current end of task 
code are as follows: 


$IFE n Test if end of task code is equal to n. 
$IFNE n Test if end of task code is not equal to n. 
$IFL on Test if end of task code is less than n. 
$IFNL n Test if end of task code is not less than n. 
$IFG n Test if end of task code is greater than n. 
$IFNG n Test if end of task code is not greater 
than n. 
In all cases, if the results of the test are "false", CSS skips 
commands until the corresponding $ELSE or §$ENDC. If a CSS 


attempts to skip beyond EOF, a command error is generated. 
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sae ee 


6.7.2 File Existence Testing Commands 


There are two commands dealing with file existence: 


$IFX fa Test fd for existence 

SIFNX fad Test fd for nonexistence 
If the result of the test is false, CSS _ skips to the 
corresponding $ELSE or $ENDC command. If a CSS attempts to skip 
beyond EOF, an error is generated. 
If the file descriptor is omitted when entering $IFX, the result 
is always considered false. If $IFNX is entered without the fd, 
the result is always considered true. 


6.7.3 Parameter Existence Testing Commands 


There are two commands dealing with the existence of parameters: 


SIFNOLL @n Test if @n is null 

SIFNNULL @n Test if @n is not null 
If the result of the test is false, CSS skips to the 
corresponding $ELSE or $ENDC command. If such skipping attempts 
to skip beyond EOF, a command error is given. 
The use of the multiple @ notation to test for the existence of 


higher level parameters is permitted. In addition, a combination 
of parameters can be tested simultaneously. 


Example: 


$IFNU @182@3 


In effect, this tests the logical AND of @1, @2, and @3 for 
nullity. If any of the three is present, the test result is 
false. 
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6.7.4 $ELSE Command 


The $ELSE command is used between the $IF and $ENDC command to 
test the opposite condition of that tested by $IF. Thus, if the 
condition tested by $IF is true, $ELSE causes commands to _ be 
skipped up to the corresponding $ENDC. If the condition is 
false, $ELSE terminates skipping and causes command execution to 
resume. 


Format: 


SELSE 
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H $LABEL i 
6.8 $GOTO AND $LABEL COMMANDS 
The $GOTO command is used to skip forward within a CSS procedure. 


The $LABEL is used to define the object of a $GOTO. 


Format: 


SGOTO label 


SLABEL label 


Parameters: 


label is from 1l- to 8-alphanumeric characters, the 
first of which must be alphabetic. 


Functional Details: 


The $GOTO command causes all subsequent commands to be _ ignored 
until a $LABEL command with the same label as the $GOTO command 
is encountered. At that point, command execution resumes. 


The $GOTO cannot branch into a logical IF command range but ' can 
branch out from one. 


An example of an illegal §GOTO is: 


$IF Condition 
$GOTO OUTIF 
$ENDC 

SIF Condition 


S$LABEL OUTIF 


The $LABEL occurs within an IF block (the second IF condition) 
that was not active when §GOTO was executed. 
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The following is valid, however: 


SIF Condition 
$GOTO OUTIF 
$ENDC 

SIF Condition 
SENDC 


$LABEL OUTIF 
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| S$IFEXTENSION | 


6.9 $IFEXTENSION COMMAND 


The $IFEXTENSION command is used to test for the existence of an 
extension for a given fd. If the extension exists, subsequent 
commands are executed up to the next §$ELSE or $ENDC command. If 
an extension does not exist, subsequent commands are skipped up 
to the next $ELSE or $ENDC command. 


Format: 


SIFEXTENSION fd 


Parameter: 


fd is the file descriptor to be tested to 
determine if an extension is included. 


Functional Details: 


$IFEX (with no fd) is always considered false. $IFNEX (with no 
fd) is always considered true. 
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6.10 $IFVOLUME COMMAND 


The $IFVOLUME command tests 


an fd. If a volume exists, subsequent commands are executed 
to the next $ELSE or $ENDC command. If the volume is omitted in 
the fd, subsequent commands are skipped up to the next $FELSE 


S$ENDC command. 


Format: 


SIFVOLUME fd 


Parameter: 


fa 
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is the file descriptor tested to determine 
a volume name is included. 


for the existence of a volume name in 


up 


if 


6.11 LOGICAL IF COMMANDS COMPARING TWO ARGUMENTS 


The following logical IF commands are used to compare two 


arguments. They differ from the other logical IF commands in 
that they do not test specific built-in conditions but, rather, 
test conditions provided by the user. These commands are 


available only with MTM. 


$IF . . . EQUAL 
$IF . . . NEQUAL 
$IF . . . GREATER 
$IF . . . NGREATER 
$IF . . . LESS 
$§IF . . . NLESS 
For each of the logical commands, two arguments are compared 


according to the mode. There are three valid modes: 


@ Character 
e Decimal 


@e Hexadecimal 


For character mode, the comparison is left-to-right and is 
terminated on the first pair of characters that are not the same. 
If one string is exhausted before the other, the short string is 
less than the long string. If both strings are exhausted at the 
same time, they are equal. For character mode, the arguments can 
be enclosed in double quotes if they contain blanks. The quotes 
are not included in the compare. 


For decimal and hexadecimal mode, the comparison is performed by 
comparing the binary value of the numbers. 


If after comparing the arguments for each of the commands, the 
condition is determined to be true, subsequent commands are 
executed up to the corresponding $ELSE and $ENDC. If the 


condition is false, commands are skipped up to the corresponding 
$ELSE or $ENDC. 
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6.11.1 $IF...EQUAL, $IF...NEQUAL Commands 


The $IF...EQUAL command is used to determine if two arguments are 
equal, while the $IF...NEQUAL is used to determine if two 
arguments are not equal. 


Format: 
CHARACTER 
SIF DECIMAL arg, EQUAL arg, 
HEXADEC IMAL 
CHARACTER 
$1F DECIMAL arg, NEQUAL arg, 
HEXADEC IMAL 


6.11.2 $I1F...GREATER, $IF...NGREATER Commands 


The $IF...GREATER command is used to determine if arg; is greater 
than argg. The §$IF...NGREATER command is used to determine if 
arg, is not greater than arg,. 


Format: 
CHARACTER 
$IF DECIMAL arg, GREATER arg» 
HEXADEC IMAL 
CHARACTER 


$IF DECIMAL arg, NGREATER arg») 


HEXADEC IMAL 
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6.11.3 §$I1F...LESS, $I1F...NLESS Commands 


The $IF...1.ESS command is used to determine if arg, is less than 
arg, - The $IF...NILESS command is used to determine if arg, is 
not less than arg,. 


Format: 
CHARACTER 
$IF DEC IMAL arg, LESS arg», 
HEXADEC IMAL 
CHARACTER 


SIF DEC IMAL arg, NLESS arg, 


HEXADEC IMAL 
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CHAPTER 7 
SPOOLING 


7.1 INTRODUCTION 


The OS/32 Package (Revision 6.2 or higher) now comes with two 
spooler tasks: 


@e the 0S/32 spooler, and 


e the SPL/32 spooler 


Both spoolers offer input and output spooling capabilites to the 
MTM user. The SPL/32 spooler offers a more extensive range of 
features and capabilities than the 0OS/32 spooler. The system 
administrator determines which spooler will be used on a system 
by selecting the appropriate sysgen statement. Only one’ spooler 
can be active on the system at any given time. The OS/32 System 
Generation (SYSGEN) Reference Manual presents detailed 
information regarding the procedures for sysgening either 
spooler. 


NOTE 


The manner in which pseudo devices are 
specified and used in the spooling 
environment differs among the two 
spoolers. Pseudo devices created for the 
OS/32 spooler are not compatible with 
pseudo devices created for the SPL/32 
spooler. Do not attempt to mix the 
various pseudo device types. 


7.2 THE OS/32 SPOOLER 


The OS/32 spooler is Perkin-Elmer's first generation spooler and 
until this release was’ the only spooler available with OS/32. 
This spooler provides basic input and output spooling services 
with minimal flexibility and control over the _ spooling 
environment. The following sections detail the manner’ in which 
an MTM user can utilize the spooling capabilities of OS/32 
spooling. 
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7.2.1 Input Spooling 

Input spooling is a process whereby a card deck of information 
(such as source programs, operator commands, command substitution 
system (CSS) files, or user data, is copied into a disk file for 
immediate or subsequent processing. 

7.2.2 Input Spooling Control Card Statements 

Each batch of cards to be spooled to disk must be preceded by a 
control card statement. This statement specifies the fd to which 
the input data (card file) is to be spooled. The OS/32 spooler 
provides two such control statements: 


@ /@INPUT 


e /@SUBMIT 


7.2.2.1 The /@INPUT Control Statement 
The /@INPUT control statement is used to copy a card file to a 
specified fd on disk. The resulting file can be explicitly 


assigned and read by the user in order to access the _ spooled 
information. 


Format: 


/@INPUT fd/actno [,DELETE ] 


Parameters: 

fd is the file descriptor of the disk file in the 
form of voln:filename.ext. The only required 
field is filename. If voln is omitted, the 
Gefault spool volume is used. 

actno is the account number the terminal user’ signs 
on with. 

DED_E'TE specifies that if a file with the same name 


and account number already exists, that file 
is deleted and reallocated. 


CAUTION 


IF THE WRONG ACCOUNT NUMBER I[S ENTERED, 
THE USER MIGHT DELETE ANOTHER USER FILE. 
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Example: 


A task requires five input data records in order to execute. In 
the following example, TEST.DTA in account 12 is identified as 
the file to which the five data records are to be spooled. If 


the file TEST.DTA currently exists on disk it will be deleted and 
reallocated as specified by the DELETE option in the /@INPUT 
statement. 


/@IN TEST.DTA/12,DELETE 
4 INPUT TEST 

122736 

545627 

889710 

632192 

/@ 


7.2.2.2 The /@SUBMIT Control Statement 


The spooler can also be used to submit batch jobs to MTM. This 
is done through the /@SUBMIT control statement. This statement 
copies a card file to disk and then submits the file as a batch 
job. The commands located within the spooled batch file are 
executed in sequence. The file remains on the disk after 
execution. 


To add batch jobs to the batch queue via the spooler, submit a 
control statement card with the following format: 


Format: 


/@SUBMIT fd/actno [, DELETE ] 


Parameters: 
fda is the name of the command file; i.e., the 
batch job, that is to be placed on the batch 
queue. 
actno is the account number the terminal user signs 
on with. 
DELETE specifies that if a file with the same name 


and account number exists, that file is to be 
Geleted and reallocated. 


The end of a card file is signified by placing the symbols /@ in 
columns 1 and 2 of the last card in the file. 
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Refer to the OS/32 System Support Utilities Reference Manual _ for 
more detailed information on the OS/32 spooler. 


The following examples are presented to illustrate two methods of 
submitting a batch job through the OS/32 spooler. 


Method 1: 


First, a CSS file named DATA is copied from a card file to a disk 
file named TEST.CSS on account number 12 on the default’ spool 
volume. If TEST.CSS already exists, it is deleted and 
reallocated. This is done as follows: 


/@®INPUT TEST.CSS/12,DELETE 
LO DATA 

AS 1,DATA.DTA 

AS 3,PR: 

AS 5,MAGL: 

START 


/@ 


The CSS file TEST.CSS created with the previous /@INPUT statement 
now can be submitted as a batch job named TEST.JOB via the 
/@SUBMIT control statement. If a file already exists on the disk 
with the name TEST.JOB, it is deleted and reallocated. When 
running concurrent batch jobs, each signon ID must be unique. 


/@SUBMIT TEST.JOB/12,DELETE 
SIGNON ME,12,PASSWD 

[L.0G PR: 

'25T.CSS 

SIGNOFF 

/@ 


Method 2: 


The procedures shown in Method 1 can also be performed in one 
step, as the following example shows. In this example the 
process of creating a CSS file and then submitting the CSS file 
as a batch job is combined into one step. If the file TEST.JOB 
already exists on the disk, it is deleted and reallocated. After 
this batch job completes, the file TEST.JOB remains on the disk. 
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/@SUBMIT TEST.JOB/12,DELETE 
SIGNON ME,12, PASSWD 

LOG PR: 

LO DATA 

AS 1,DATA.DTA 

AS 3,PR: 

AS 5,MAG1: 

START 

SIGNOFF 


/@ 


7.2.3 Output Spooling 


Output spooling is a process in which information destined for a 
physical output device, such as a printer or card punch, is 
initially copied to a disk file. This file is then copied by the 
spooler to the physical output device on a task priority basis. 
This process enables multiple tasks to be generating output for 
the same output device since output is not routed directly to the 
device as it is generated. 


To make use of the output OS/32 spooler, assign any logical units 
(lu) to be printed or punched to one or more pseudo devices. As 
soon as the lu is closed, the OS/32 spooler automatically will 
print or punch the results. Printing or punching may be delayed 
because of a backlog to the device. 


There is no limit to the number of tasks or logical units that 
can be assigned to a pseudo device. After the user makes an lu 
assignment to a pseudo device, the following occurs’ internally: 
the operating system automatically intercepts all assignments to 
that pseudo device and allocates an indexed file called a _ spool 
file on the spool volume. Subsequent output calls cause data to 
be written to this file and not to the device. The spooler 
supports both image and formatted writes. 


When the lu assigned to the spool file is closed, the ,filename, 


task name, and priority are placed into the spooler print or 
punch queue. The queue is maintained as a file on the spool 
volume. If there is an entry on the queue, the output spooler 


begins printing or punching and stays active as long as there is 
something on the queue. Files are spooled and output ona task 
priority basis. The user must ensure that sufficient disk space 
is available to accommodate output spooling. The user task is 
responsible for handling end of medium (EOM) status while writing 
to spool files within their own standard I/O error recovery 
routines. 


Printing multiple copies of a disk file or punching multiple 
copies of a card deck is accomplished through use of the spooler. 
To print or punch a disk file using the spooler, issue a command 
through MTM from the terminal. This is done with the PRINT and 
PUNCH commands. See Sections 2.38 and 2.39. 
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If the device specified in a PRINT or PUNCH command does not 
support printed output or output punching respectively, the 
output will be generated in the way that is supported on the 
specified device. 
For print files, a header page precedes each file printed. The 
header page has the format: 

USERID 

ACCOUNT NUMBER 

TIME OF DAY 

DATE 
When a file is directed to a card punch file, each output’ record 
is 80 bytes in length. A header card precedes the punched 


output; a trailer card terminates the punched output. Header 
suppression is not supplied. 


Example: 


To list and punch a file named TEST.CSS in account number 12 = on 
the volume MTM using the OS/32 spooler, enter: 


SIGNON ME,12,MEPASS 
PRINT MTM: TEST.CSS 
PUNCH MTM:TEST.CSS 
SIGNOFF 


The header page for the print examples reads: 


TEST 
Ac=00012 
14:36:50 
07/08/77 
7.2.4 Spooling Errors 
The following message is generated by the operating system in 


response to a spooler command. 


FILE voln:filename.ext/acct NOT ENTERED ONTO PRINT QUEUE 
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A spool file was closed but the spooler task was not loaded or 
started. The system operator can reenter a .SPL PRINT command 
when the spooler is started. 

7.3 THE SPL/32 SPOOLER 

The SPL/32 spooler is the latest spooling product offered with 
the OS/32 operating system. SPL/32 will only execute on systems 
running Revision RO6.2 or higher of OS/32. 

SPL/32 offers increased flexibility in creating and controlling 


the spooling environment of a system. Some of the features of 
SPL/32 include: 


e The number of output devices is dependent only on the amount 
of available memory. 


@e Capability of retaining a spooled output file after it is sent 
to a device. 


e Capability of holding spooled files from output processing. 

e The option to backspace, forward space, or rewind a file that 
is currently being output by the spooler, and then resume 
output. 


e The option to produce up to 255 copies of an output file. 


e The option to print informative header and trailer pages to 
identify output files. 


@e The capability of using preprinted forms and testing for form 
alignment before output. 


@e The capability to alter the output requirements of a file 
waiting to be output. 


@ The capability to alter the order in which files are output. 


@e The capability to control devices within the output spooling 
environment. 


e The capability to quiesce the entire output spooling function 
or individual devices in an orderly fashion. 


e The capability to add or drop spool devices dynamically. 
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7.3.1 SPL/32 and MT™ Interaction 


The SPL/32 capabilities available to an MTM terminal user are 
directly dependent upon the manner in which the_ spooling 
environment is configured. MTM users of SPL/32 should refer to 
the SPL/32 Administration and Reference Manual for specific 
details on the commands and configurational considerations of 
using SPL/32. 


In general, MTM should be designated the primary control task for 


SPL/32. This will enable all SPL/32 spooling facilities at the 
MTM terminal level. 
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APPENDIX A 
MTM COMMAND SUMMARY 


. keys 
conrrcuous, tsize| se 


“lite ff 


roy ke 


ALLOCATE fd, 


(access privileges SVC15 


ASSIGN lu,fd |, 


BFILE [fd,] lu 


we 


x 


_ 


BREAK 


BRECORD [fd,] lu 
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erst) feet) el 


fd 
BUILD [, APPEND ] 
lu 


ENDB 
CANCEL 


Lu, E luo fees me 


CLOSE 
ALL 
CONTINUE [address | 


DELETE fd, [,fdo,.-.., fdn| 


ny /Ng 
GVARIABLE 
DISPLAY alae 


IVARIABLE 


DISPLAY ACCOONTING |, , 


DISPLAY DEVICES 


DISPLAY DFLOAT 4 
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DISPLAY FILES , voln: [filename] 


default user vol 


DISPLAY FLOAT | 


DISPLAY LU |, 


DISPLAY PARAMETERS Ne 


DISPLAY REGISTERS |, 


DISPLAY TIME ; 


DISPLAY USERS | 
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[- [ext] ] 


MESSAGE 


PROMPT 
ENABLE 
ETM 
$VARIABLE 
n 
EXAMINE address, /address2 > | 7 


FEILE [fd,] lu 
FRECORD [fd,] lu 


mnemonic 
HET.P 


x 


segsize increment) | 
INIT fd |, 


JNQUIRE ra) 


LOAD [taskid,]fd[,segsize increment] [ScTASK_] 


a 


SET Loc [fa] |, 


Loc [fa] |, } 


userid 
MESSAGE 


message 


+» OPERATOR 
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data, 
MODIFY address, [, data, ,.++,datan| 


AF PAUSE SVCPAUSE 
OPTIONS ; 


[; NONRES I DENT ] 


AF CONT INUE SVCCONT INUE 


PASSWORD current password, new password 


PAUSE 
MESSAGE 
PROMPT 
PREVENT 
ET™ 
$VARIABLE 


PRINT fd [,DEVICE=pseudo device] [,CQPIES=n] [,DELETE] [,VFC] 
PUNCH fd [,DEVICE=pseudo device] [,COPIES=n] [,DELETE] [,VvFc ] 
PURGE fd 


ny /Nng 
GVARIABLE 


snezease | ny... enn] 
IVARIABLE 


RENAME oldfd,newfd 
REPROTECT fd,new keys 


REWIND [fd,] 1u 
or 


RW [fa,] lu 
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peee,mMax actno|/ 


woffa 


actno; ,...,max actno 


RVOLUME voln, 


REMOVE , 


actno 


USERS|,‘actno; - actnog 


SEND message [; ] 

SET GROUP n 

SET KEYOPERATOR [character ]| 
SET PRIVATE n 

SIGNOFF 


fd 
SIGNON userid,actno, password | ,ENVIRONMENT= 
NULL [ :] 
[, CRUTIME=maxt ime | 


E classid=iocounty [ ...,classid= iocountsz] | 


VEC 


SPOOLFILE lu&lul,pseud dev, FORM=formname | 


| 


,BLOCK= blocksize/indexsize 


NOIMAGE | cm HOLD 


. [, COPIES=n] 4, 


[, PRIORITY=p] 
NODELETE 


A-6 48-043 FOO RO1l 


address 
START © . [, parameter, ,...,parametery | 


[SUBMIT fd ,DELETE] [,PRIORITY=priority] 
taskid 
TASK 
_..BGROUND 
CONTIGUOUS, fsize 


bsize isize 


TEMPFITLE lu, 


VOLUME [voln ] 


WFILE [ fa,]|1u 


XALLOCATE fd, 


XDELETE fd, [,fd2...,fdn] 
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APPENDIX B 
PROGRAM DEVELOPMENT COMMAND SUMMARY 


ADD fa ([,cssprod | 


voln: filename 
COMP ILE 5 | . 


filename 


COMPLINK 


("start parameters" | 


| 
(i sara | 
| 


filename ] 


LIST 
REMOVE fd 
voln: filename 
RUN . [, "start parameters" | 
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APPENDIX C 


CSS COMMAND SUMMARY 


char lchar 2, [char1 iia x 


% 
% new delimiter 


fd 
S$BULLD {[-areeno] 
Lu 


$ENDB 
SCLEAR 
SCONT INUE 
SCOPY 


GVARIABLE 


SEF INE} nf [rane] operator 


SELSE 
SENDC 
SEXIT 


$FREE varname, [,...,varnamen] 


[operator, ...operatorn| 


length length 
$GLOBAL varname cue poe -,Varname = 
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$GOTO label 


S$LABEL label 


CHARACTER 
$IF DEC IMAL arg, EQUAL arg, 


HEXADEC IMAL 


CHARACTER 


SIF DECIMAL. arg, NEQUAL arg, 


HEXADEC IMAL 


CHARACTER 


$IF DECIMAL arg, GREATER arg» 


HEXADEC IMAL 


$IF DEC IMAL arg, NGREATER arg, 


HEXADEC [MAL 


~ CHARACTER 


$IF DEC IMAL arg, LESS arg, 


HEXADEC IMAL 


CHARACTER 


$IF DECIMAL arg, NLESS arg» 


Ne em em em Tee le 


! 
! 
: 
: 


HEXADEC IMAL 
SIFE n 


SIFEXTENSION fd 
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SIFG n 


$IFL n 


$IFNE n 


$IFNG n 


$IFNL n 


SIENUI.L @n 


SIENNULL @n 


SLEVOLUME fd 


G$IFX fd 
SIFNX fd 
SJOB 


CPUTIME=maxt ime 


[class id=iocount,] [--- 


STERMJOB 


length 
$LOCAL varname a 


SNOCOPY 


SPAUSE 


PRIOR n 
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.,classid= iocount9| 


GVARIABLE 
SRELEASE °<Ty 


LIVARIABLE 


$SET varname=e 


SET CODE n 


SSKIP 


SWRITE text [;] 
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APPENDIX D 
MTM MESSAGE SUMMARY 


ACCESS PRIVILEGE ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made to access a valid segment in an 


mode; i.e., store into a write protected segment; 


instructions from an execute protected segment; load 
read protected segment. 


ACCT-ERR 


The account number specified is not a valid account. 


ALIGNMENT FAULT INSTRUCTION AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXxXxX 


invalid 
execute 
from a 


Data instruction not properly aligned to specific fields for 
fullword or halfword alignment. The memory fault address is 
the memory location that is not properly aligned. The memory 
fault address is given only on Perkin-Elmer Series 3200 


Machines. 


AI.LO-ERR TYPE=NAME 


A desired filename currently exists on the specified 


vo Lume. 


The block size of an indexed file exceeds limit established 


at sysgen time. 


For an indexed file, a zero logical record length 
block size was specified. 


ALLO-ERR TYPE=TYPE 


The’ volume specified is not a direct access device. 


ALLO-ERR TYPE=VOL 


The volume name specified, or the name it defaulted 
not the name of any of the disks currently online. 
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or data 


to, is 


ACCT-ERR 


The account number specified is not valid. 


ARGS -ERR 
The amount of space between CTOP and UTOP is insufficient for 
placement of START command arguments by the command 
processor. 

ARITHMETIC FAULT AT XXXXXX 
A fixed or floating point error was detected at address 
XXXXXX, Or an attempt was made to divide by zero. This only 
occurs on Perkin-Elmer Models 7/32 and 8/32 machines. 

ASGN-ERR 


The assign failed for reason denoted by TYPE field. 


ASGN-ERR TYPE=BUFF 
An attempt was made to assign a file when there was 
insufficient system space available to accommodate the FCB. 
ASGN-ERR TYPE=LU 
An attempt was made to assign to an lu that is greater than 
the maximum lu number specified at Link time. 
ASGN-ERR TYPE=NAME 


An assignment is being directed to a nonexistent file. 


ASGN-ERR TYPE=PRIV 


The privilege to assign the file or device cannot be granted. 
The access privileges may be incompatible with other current 
assignments to the same fd, 


or, a request was made to assign to a disk when bare disk 
privileges are not enabled, 


or, requested privileges may conflict with user's file access 


privileges (e.g., assigning system file EWO when only SRO is 
valid). 
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ASGN-ERR TYPE=PROT 
The file being assigned to is unconditionally protected (read 
and/or write keys=X'FF') or the read/write keys specified in 
the ASSIGN command do not correspond to those associated with 


the file, and the file is conditionally protected (read 
and/or write keys not X'OO' or X'FF'). 


ASGN-ERR TYPE=SIZE 


An indexed file is being assigned and there is not’ enough 
room on the disk to allocate a physical block. 


ASGN-ERR TYPE=SPAC 


An assign is refused because the available task system space 
was exceeded. 


ASGN-ERR TYPE=TGD 


An attempt was made to assign a trap generating device. 


ASGN-ERR TYPE=VOL 


Volume name specified or defaulted to is not the name of any 
of the disks currently online. 


BTCH-ERR 


The batch capability was not started and is not available for 
a SUBMIT command. 


BUFF -ERR 


The expanded CSS line overflowed CSS buffer size. 


CLOS-ERR 


Close failed for reason denoted by TYPE field. 
DELE-ERR TYPE=ACCT 


An attempt was made to delete a file not on the user's 
private account. 
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DEL-ERR TYPE=ASGN 


An attempt is being made to delete a file that is currently 
assigned, or is being processed by the CSS processor. 


DELE-ERR TYPE=BUFF 


There is insufficient memory available in system space to 
perform a delete function. 


DELE-ERR TYPE=DU 


An attempt was made to delete a file from a device that is 
not on Line. 


DELE-ERR TYPE=[10 


An I/O error was encountered while attempting to delete a 
file. 


DELE-ERR TYPE=NAME 


File with a specified name was not found. 


DELE-ERR TYPE=PROT 


An attempt is being made to delete a file with nonzero 
protection keys. 


DELE-ERR TYPE=TYPE 


The volume name specified or defaulted to is not a direct 
access device. 


DELE-ERR TYPE=VOL 


The volume name specified or defaulted to is not the name of 
any of the disks currently online. 


DUPLICATE USERNAME 


Userid is already in use. 


FD-ERR 
The file descriptor is syntactically incorrect or invalid, or 


a program on the disk is being loaded without enough system 
space. 
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fd IS NOT A CONTIGUOUS FILE 


The INIT command can only be used to initialize contiguous 


files. 


FILE voln: filename. ext/acct NOT ENTERED ONTO PRINT QUEUE 


A spool file was closed but the spooler task was not loaded 


or started. 


FIXED POINT-ZERO DIVIDE ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXXX 


An attempt was made to divide by zero. Current instruction 


aborted, and next instruction at address xxxxxx. 


FIXED POINT-OVERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 


Fixed point arithmetic result is too large to be represented. 


Instruction aborts. Next instruction at xxxxxx. 


FLOATING POINT-UNDERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 


Results of floating point operation are too small to 
represented. Instruction aborts. Next instruction 
XXXXXX. 


FLOATING POINT-OVERFLOW ERROR AT XXXXXX 
NEXT INSTRUCTION AT XXXXXX 
Floating point arithmetic procedure is too large to 


represented. Instruction aborts. Next instruction 
XXXXXX. 


FLOATING POINT-ZERO DIVIDE ERROR AT XXXXXX 
NEXT [INSTRUCTION AT XXXXXX 


An attempt was made to perform a floating point divide 
zero. 


FORM-ERR 


be 
at 


be 
at 


by 


The command format is invalid or invalid account number 


specified. 
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GOTO-ERR 


A $ILABEL that is terminating the range of the §GOTO is 
branching into an IF group. 


ILLEGAL INSTRUCTION AT XXXXXX 


The user task attempted to execute an illegal instruction at 
location XXXXXxX. 


ILLEGAL SVC-INSTRUCTION AT XXXXXX 
SVC PARAMETER BILOCK AT XXXXXX 


The user task attempted to execute an illegal SVC at location 
XXXXXX. 


INVALID SEGMENT ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXxXxXxX 


An attempt was made to access a memory location not within a 
valid mapped segment; i.e., an attempt to access a memory 
location outside of the task space. 


INVALID ACCOUNT 


Invalid or unrecognized account number. 


INVALID PASSWORD 


Password is invalid. 


1/O-ERR 


A device/file being accessed by MTM is returning a nonzero 
I/O status. 


I/O-ERR TYPE=DU 


The device is unavailable. 
I/O-ERR TYPE=EOM I[/O-ERR TYPE=EOF 


The device reacned an EOM or EOF before completing the 
operation. 
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I/O-ERR TYPE=FUNC 


An invalid operation is being directed toward a device; e.g., 
attempting to write to a read-only device. 


I/O-ERR TYPE=LU 


An illegal or unassigned lu. 


I/O-ERR TYPE=PRTY 


A parity or other recoverable error occurred. 


I/O-ERR TYPE=UNRV 


An unrecoverable error occurred. 


JOBS -ERR 


A $JOB statement was encountered following another $JOB 
statement but prior to a $TERMJOB statement. 


JOB NOT FOUND 


The fd of job to be purged is invalid or is not in the batch 
job queue. 


LOAD-ERR TYPE=ASGN 


Load could not be accomplished because the specified fd is 
already exclusively assigned or could not be found. 


LOAD-ERR TYPE=DU 


Attempt was made to load from an unavailable device. 


LOAD-ERR TYPE=1/0 


An I/O error was generated during the load operation. 


LOAD-ERR TYPE=LIB 
The data in the loader information block is invalid. This 


error most frequently occurs when an attempt is made to load 
a task which was not built with Link. 
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LOAD-ERR TYPE=LOPT 
Task options are incompatible with the system environment 
that attempts to load the task; i.e., attempt to load an 


e-task under MTM where e-task loading under MT! is not 
enabled. 


LOAD-ERR TYPE=MEM 


A load was attempted without enough memory specified for the 
task's work space. 


LOAD-ERR TYPE=MTCB 


The maximum number of tasks specified at sysgen time was 
exceeded. 


LOAD-ERR TYPE=NOFP 


A task requiring floating point support is being loaded, and 
the required floating point option is not supported in the 
system. 


LOAD-ERR TYPE=SEG 


A task requiring a task common area (TCOM) and/or a run-time 
library (RTL) is being loaded. The TCOM/RTL is not in the 
system and cannot be loaded. 


LOAD-ERR TYPE=ROIO 


There is an I/O error on the roll volume. 


LOAD-ERR TYPE=RVOL 


There is a roll file allocation or assignment error. 


LU-ERR 


An lu specified in an assign statement is invalid. 


LVL-ERR 


The number of sysgen CSS levels was exceeded. 
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MEMORY ERROR ON DATA FETCH AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXxX 


Attempt was made to retrieve or to load data from a failing 


memory area on Perkin-Elmer Series 3200 machines. If 
affected memory is within task space and the operating system 
has memory diagnostic support, the affected page is 


automatically marked off, and this message is displayed: 
AFFECTED MEMORY PAGE MARKED OFF AT XXXXXX 
MEMORY ERROR ON INSTRUCTION FETCH AT XXXXXX 


MEMORY FAULT ADDRESS=XXXxXXxX 


A Perkin-Elmer Series 3200 machine attempted to execute an 


instruction from an area of memory that is failing. If 
affected memory is within task space and the operating system 
has memory diagnostic support, the affected page is 


automatically marked off, and this message is displayed: 


AFFECTED MEMORY PAGE MARKED OFF AT XXXXXX 


MEMORY PARITY ERROR AT XXXXXX 


Attempt made to access nonexistent or bad memory on Models 
7/32 and 8/32 machines. 


MISSING PASSWORD 


Password omitted. 


MNEM-ERR 
The command mnemonic entered is unrecognizable or a 


non-privileged user attempted to use a command that requires 
privileged status. 


NOF P-ERR 


No floating point support exists in the system. 


NON EXISTENT SEGMENT ERROR (PST) AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXxXX 


An attempt was made to access a memory location greater than 
the maximum valid program address; i.e., an attempt to access 
a memory location outside of the task space. 
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NOPR-ERR 
A command was entered that required more parameters’ than 
specified in the command line. 

PACKED FORMAT-SIGN ERROR AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXXxX 
An illegal sign digit was detected in a packed decimal number 
at xxxxxx for Perkin-Elmer Series 3200 machines only. 

PACKED FORMAT-DATA ERROR AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXXX 
A data error was detected in a packed decimal number at 
XXXxxx for Perkin-Elmer Series 3200 machines only. 

PARM--ERR 


A command was entered with invalid or missing parameters. 


PRIV-ERR 
The access privilege mnemonic is syntactically incorrect, or 
an MTM user without access privileges tried to access a 
restricted file. 


RENM--ERR TY PE=NAME 


A filename already exists in the volume directory. 


RENM-ERR TYPE=PRIV 
The file/device cannot be assigned for ERW (required to 
perform the rename) because the file/device is currently 
assigned to at least one lu. 

RENM-ERR TYPE = PROT 
The protection keys of the file to be renamed are not 
X'OOOO'. 

REPR-ERR TYPE=PRIV 
The file/device cannot be assigned for ERW (required to carry 


out the reprotection) because the file/device is currently 
assigned to at least one lu. 
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ROLL-ERR 


The task is currently rolled out. 


SEGMENT LIMIT ADDRESS ERROR AT XXXXXX 
MEMORY FAULT ADDRESS=XXXXXX 


An attempt was made to access a memory location within a 
valid mapped segment, but the page number in the segment is 
greater than the largest valid page number for the _ segment; 


i.e., an attempt to access a memory location outside of the 
task space. 


SEQ-ERR 


A command was entered out of sequence or when user was not in 
the appropriate mode (e.g., CSS call in task loaded mode). 


SIGNON REQUIRED 


Attempt to enter a command before signon or a mistake in the 
SIGNON command. 


SKIP-ERR 


An attempt was made to skip beyond the end of a CSS job. 


SPAC-ERR 


Task exceeds established maximum system space. 


SVC ADDRESS ERROR-INSTRUCTION AT XXXXXX 
SVC PARAMETER BLOCK AT XXXXXX 


Incorrect address of SVC parameter block at xxxxxx. The SVC 
parameter block must be on a fullword boundary. 


SVC6-ERR TYPE=ARGS 


There is insufficient room between UTOP and CTOP to contain 
the start option string. 


SVC6-ERR TYPE=DORM 


A command was issued to a specified task that is dormant. 
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SVC6-ERR TYPE=NMSG 


The directed task could not receive a message trap. 


SVC6-ERR TYPE=PRES 


The directed task is not present in memory. 


SVC6-ERR TYPE=QUE 


The message could not be queued to the directed task. 


TASK-ERR 


A task-related command was entered and there is no currently 
loaded task. 


TIME -ERR 
A task cannot be loaded because the user account CPU limit 
expired. 

UNDEFINED DATA FORMAT FAULT AT XXXXXX 

MEMORY FAULT ADDRESS=XXXXXX 


An undefined data format/alignment fault was detected at 
XxXxxxx for Perkin-Elmer Series 3200 machines. 


USER -ERR 


An invalid userid was entered in a MESSAGE command. 


VOLN -ERR 


The volume specified is not online or the volume name _ is 
invalid. 


XxXxX ERROR ON fd SECTOR n 
An I/O error occurred while attempting to initialize sector 


n of file fd. Xxxx is the type of error; it may be 
unrecoverable I/O, recoverable I/O, or device unavailable. 
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APPENDIX E 
CSS MESSAGE SUMMARY 


BUFF -ERR 


indicates an expanded command line exceeds the CSS buffer. 
The task skips to $TERMJOB. 


DBUF -ERR 


The operators of a $DEFINE command create a result that is 
greater than 110 characters or the command buffer 
size-whichever is smaller. 


DEFO-ERR 


more than 8 characters specified for a keyword or a_ required 
name in the REQUIRED operator. 


DEF 1-ERR 


an illegal character is specified in a keyword or a_ required 
name specification. A through Z are the only valid 
characters and they must be capital letters. 


DEF 2-ERR 


an empty additional Keyword after a quote was used in a 
SEARCH operator specification. 


DEF3-ERR 
the specified variable name is already in use. 
DEF4-ERR 
the REQUIRED operator must be the last operator specified in 


a $DEFINE command. 


DEF 5-ERR 


divide by zero attempted. 
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DEF6-ERR 


arithmetic fault - result is greater than Y'OFFFFFFF'. 


DEF 7-ERR 
a negative hexadecimal value was’ specified. Only positive 
values are allowed. 

FD-ERR 
illegal or invalid file descriptor, or indicates not enough 
space to build an fd, or required file support is not in 
system. The task skips to $TERMJOB. 

FORM-ERR 
indicates a command syntax is invalid. The task skips’ to 
$TERMJOB. 

GOTO-ERR 
indicates a $LABEL occurred inside an IF block that was not 
active at the time of the $GOTO command. The task skips to 
$TERMJOB. 

I /O-ERR 
indicates an EOF was found while skipping to $ENDC, an _ EOF 
was found before a $ENDB while building a file, or a $TERMJOB 
was found while skipping to $ENDC within a job. The CSS 
skips to $TERMJOB, end of task code is set to 255, and job is 
ended. 

JOBS-ERR 
indicates a second $JOB was found before a §$TERMJOB_ was 
found. 


KEYW-ERR 


a syntax error detected in a keyword, in a Keyword parameter, 
or a positional parameter appears after a keyword. 


E-2 48-043 FOO ROL 


LVL-ERR 


indicates the CSS levels’ required exceed the number 
established at sysgen time. 


MNEM-ERR 


indicates the command entered is not’ recognized. The task 
skips to $TERMJOB. 


NOPR-ERR 


required operand for a command was not specified. 


PAIR-ERR 


the ‘' or " symbols are not matched. 


PARM-ERR 


indicates a command was entered with invalid or missing 
parameters or a variable number is not in allowed range. 


REQS-ERR 
REQUIRED operator is not allowed when used with new global 


variables in a §$DEFINE command, or a syntax error was 
detected in a REQUIRE operator. 


SEQ-ERR 


indicates a command was entered out of sequence or a 
privileged command was used by a non-privileged user. 


TASK-ERR 


indicates a task-related command was entered and there is no 
currently loaded task. The task skips to $TERMJOB. 


%REP-ERR 
invalid replacement string definition or more than 4 
replacement strings defined in a single character replacement 
command. 
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@SYSXXXX VARIABLE ERROR, ILLEGAL NAME 
indicates that a variable was defined beginning with the 
reserved characters @SYS or an attempt was made to free a 
system variable. 

@XXXX-VARIABLE ERROR, ALREADY EXISTS 
indicates an attempt was made to define a local variable that 
already exists. 


@XXXX-VARIABLE ERROR, EXCEEDS USER LIMIT 


indicates that the variable limit set at sysgen was exceeded. 


@XXXX-VARIABLE ERROR, DEFINITION TOO LONG 
indicates that the length of the defined variable is greater 
than 32. 

@XXXX-VARIABLE ERROR, DOES NOT EXIST 
indicates an attempt to set, free, or access the value of a 
nonexistent variable. Also, during CSS execution, a variable 
definition is required. 

@XXXX-VARIABLE ERROR, DEFINITION DOES NOT EXIST 
indicates an attempt to set the value of a variable to the 
value of a second nonexistent variable. 

@SYSCODE-VARIABLE ERROR, UNABLE TO ACCESS PAGE-FILE 
indicates that at signon time MTM was unable to access’ the 
variable page file. 

VARIABI.E ERROR, VARIABLE PROCESSING NOT SUPPORTED 
indicates that one of the following variable related commands 


was entered into a system that does not support variable 
processing: 


- $FREE 

- $GLOBAL 
- $LOCAL 
- $§SET 
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VARIABLE ERROR, VARIABLE PROCESSING DISABLED 


indicates that one of the following variable related commands 
was entered into a system with variable processing support 
that is disabled: 


- FREE 

- §GLOBAL 
- §LOCAL 
- $SET 
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APPENDIX F 
PROGRAM DEVELOPMENT MESSAGE SUMMARY 


ALTERNATE CSS REQUIRED 
The fd entered with the ADD command contains a non-standard 
extension, and the cssprod parameter was not specified. 
COMPILE ERROR - LINK NOT EXECUTED 


In a complink process, a compilation error was found, and the 
process aborted before the link procedure began. 


COMPILE ERRORS, [IISTING ON PR: 

Errors were encountered while compiling. These errors are 
listed on the specified pr:. 
CURRENT ENVIRONMENT - filename 


The ENV command, entered without a filename, causes the name 
of the current environment to be displayed. 


CURRENT PROGRAM NOT SET 


A filename was not specified, or no current program exists. 


EDIT - filename.ext 

In the multi-module environment, the EDIT command was entered 
without a filename. The fd of the current source program is 
displayed. 
ENVIRONMENT EMPTY 


The LIST command was entered, but there are no _ fds in the 
EDF. 


EXTENSION OMITTED 


A filename entered with the ADD or REMOVE command did not 
contain the required extension. 
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EXECUTION OF filename FOLLOWS: 


An image program is loaded and is executing. 


FILE fd NOT FOUND 


The specified filename cannot be found in the _ language 
environment. 


fd NONEXISTENT 


A specified fd does not exist in the environment. 


FILENAME CONFLICT - ENTRY NOT ADDED 


An attempt was made to add an already existing fd to the EDF. 


FILENAME NOT IN ENVIRONMENT 


An fd specified with the REMOVE command does not exist in the 
EDF . 


LANGUAGE ENVIRONMENT NOT SET 


A development command such as’ EDIT, COMPILE, COMPLINK, or 
EXEC was entered without first setting the language 
environment. 


ILINK ERRORS - EXECUTION ABORTED 


Program execution aborted when a link error was encountered. 


NEW ENVIRONMENT 


An empty EDF has been allocated. 


NEW PROGRAM 


An empty source file is allocated in the language 
environment. 


NO CURRENT EDF 


The ENV command was entered without an EDF name, or there is 
no current EDF. 
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** NON-STANDARD EXTENSION 


An attempt was made to add an fd with a non-standard language 
extension to the EDF without specifying a cssprod parameter. 


** NOT IN MULTI-MODULE ENVIRONMENT 


A command that is only meaningful in a multi-module 
environment was specified in a language environment. 


** SOURCE FILE NOT FOUND 


The specified source file cannot be found. 


x** SYNTAX ERROR 


An fd was not specified with the ADD or REMOVE command. 


** TASK fd NOT FOUND 


The specified task cannot be found. 


** TOO MANY ARGUMENTS 


Arguments were specified in a multi-module environment. 
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APPENDIX G 


MTM/NON-MTM TASK INTERFACE MESSAGES 


G.1 $FOREGROUND TASK INTERFACE MESSAGES 


XXXX-ERR SNDTID = sender task-id MSGE: received message 


Where: 


xXxXxXX can be any of the following error statuses: 


PARM 
TNEX 
‘TNCM 


TASE 


DSTA 


DEND 


MSTA 


MEND 


MNEM-ERR 


MOSQ -ERR 


NTSK-ERR 


SEQ-ERR 


SMGS-ERR 


bad syntax in terminal-dn 


specified terminal-dn not known by MTM 


terminal not in correct mode 


terminal assign error on $END message (still 
assigned to FOREGROUND task?) 


duplicate $STA message for the same 
terminal-dn received 


duplicate $END message for the same 
terminal-dn received 


missing $STA message 


missing $END message 


interface not 


mode sequence 
MTM mode 


selected task 
name 


task loaded, 
system (CSS), 


available for normal MTM users 


error - terminal not in normal 


not in foreground or restricted task 


task executing, command substitution 
or batch mode 


send message error 
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#MST-ERR 


#MEN-ERR 


TASE-~ERR 


TSPC-ERR 


‘missing $STA message from FOREGROUND task - terminal 


reassigned 


missing $END message from FOREGROUND task - terminal 
reassigned 


FOREGROUND task assign-error 


FOREGROUND task has no more space to add the _ users 
terminal, try again later 


G.2 HASP INTERFACE MESSAGE 


MNEM-ERR 
SEQ-ERR 
NTSK -ERR 


USED-ERR 


TSPC-ERR 


SMGS -ERR 


nonprivileged user entered the $HASPxx command 
terminal in CSS, batch mode, task loaded or executing 
no such HASPxx task-id found in foreground 


selected HASPxx currently being used by another MTM 
user 


no HASP-TUB available (more HASP tasks than specified 
by SGN.$HSP at MTM sysgen time) 


error on sending message to HASPxx 


48-043 FOO ROL 


APPENDIX H 
CONTROL SUMMARY FOR BIDIRECTIONAL INPUT/OUTPUT CONTROL (BIOC) 
CRT DRIVER 


Bidirectional input/output control (BIOC) is a standard 0S/32 
terminal driver. Listed in this appendix are function control 
codes for the BIOC, the standard control characters generated by 
the use of the codes, and the functions performed. On terminals 
that do not generate standard control characters for any of the 
function keys, it is necessary to determine which key will 
produce the required control characters’ in order to invoke a 
desired function. 


When a combination of the control key and an ASCII key cannot be 
accepted, BIOC will reject that combination and respond with a 
bell code. An example of this would be a "cancel" request 
(CTRL-X) on ae line that has no character on it. ASCII control 
characters for the BIOC will not be echoed (displayed to the 
console) to prevent confusion between BIOC functions and terminal 
functions. 


ASCII READ MODE: 


CTRL-A (SOH) Adjust Baud Rate 


The baud rate adjust function must be enabled by the system 
programmer before the CTRL-A can be used. When connection to 
a terminal is made over a dial-up line, the adjust baud rate 
mode is automatically entered. 


To change the baud rate on a Perkin-Elmer Model 1200 
terminal, for example, locate the front panel and remove the 
cover. It is important to know which baud rates have’ been 
made available to your terminal at system generation (sysgen) 
time. When this is known, depress CTRL-A and then change the 
baud rate setting inside the panel, using the scale depicted 


on the inside of the panel cover (see Figure H-1l). By 
depressing the carriage return (CR) key repeatedly, the user 
will synchronize communication at the new baud rate. BIOC 


then responds with an asterisk (*) and continues with the 
mode that was in use at the time the adjust routine was 
begun. 
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BAUD RATE : DUPLEX 


Figure H-l Perkin-Elmer Model 1200 Mode Selectors 


CTRL-B (STX) Backspace (Nondestructive) 


This code causes the cursor to backspace one character for 
each time the code is used. To be effective, CTRL-B cannot 
be entered at the first character position on a _ line. When 
the cursor has been backspaced to the desired character 
position, the Line may be changed by typing the desired 
characters. All other characters backspaced over can be 
restored and the cursor brought back to the end of the _ line 
in one of two ways: 


e cCTRL-F, moves the cursor forward one character at a time 


e CTRL-Z, "zooms" the cursor immediately to the end of the 
Line 


CTRL-C (ETX) Capture the Last Line Entered 


Entering this code will cause the last line entered (maximum 
of 80 characters) to be displayed on the console. By using 
CTRILL-C repeatedly, character strings can be concatenated. If 
an insert or delete function is performed, the CTRL-C code 
will be rejected and a bell will sound to remind you that the 
buffer has now been overwritten. CTRL-C will also be 
rejected if the display of data to the console has_ been 
suppressed by the use of CTRL-E. 


CTRL-D (EOT) Device Control -- Echo Only 


The next character entered after the CTRL-D code will be 
echoed to the terminal but will not be stored in the input 
buffer. This function could be helpful, for example, if an 
auxiliary peripheral is used that requires certain control 
characters to be entered at the console. The CTRL-D code 
would prevent the peripheral control characters from being 
interpreted as program input. 
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CTRL-E (ENQ) Echo Toggle 


Each entry of CTRL-E will change the current echo state from 
ON to OFF, or from OFF to ON. This means that data display 
to the console screen can be controlled. Suppression of data 
display is useful for entering passwords without others being 
able to observe them. All functions will work with echo off 
except CTRL-C, CTRL-R, CTRL-W, CTRL-], CTRL-A, and CTRL-_.. 
A CTRL-M (carriage return), buffer full, or CTRL-X will turn 
echo back on. A CTRL-E will be rejected if the insert mode 
is selected. 


CTRL-F (ACK) Forward Space and Restore 


This code is used to restore a line that has been backspaced 
over by the CTRL-B, CTRL-W, or CTRL-] code. After the cursor 
has been moved to the desired position and the correction has 
been made, CTRL-F will move the cursor forward one character 
position at a time until it reaches the end of the _ line. 
CTRL-F will be rejected if there are no characters to be 
restored. 


CTRL-H (BS) Backspace (Destructive) 


This code is used to delete a character or characters. 
Unlike CTRL-B, however, any character(s) backspaced over by 
using the the CTRL-H code cannot be restored by using the 
CTRL-F or CTRL-Z codes and must be retyped. If they are not 
retyped, blank spaces will appear in those character 
positions. CTRL-H will be rejected if attempted at the first 
character position ina line. On most terminals the CTRL-H 
code can be generated by the "backspace" key. 


CTRL-L (FF) Set Page Pause Line Count 


To set the CRT screen display for a specific number of lines, 
the CTRL-L code is entered, followed by depressing the 
control key again with another ASCII character. The numeric 
value of the ASCII character will set the number of lines’ to 
be displayed. To select a count for a 24-line CRT, enter the 
sequence: CTRL-L, CTRL-X (X has a decimal value of 24). 


The following table shows the proper combinations for line 
displays ranging from 1 to 24. 
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TABLE H-1 LINE DISPLAY 


COMBINATIONS 
| NUMBER | 
| SEQUENCE | OF LINES } 
ee ee ee t 
oe Ae Se re rk ee eee Pe Ged OR eS ng | 
| CTRL-L CTRL-A } 1 
| CTRL-L CTRL-B | 2 
| CTRL-L CTRL-C } 3 
| CTRL-L CTRL-D } 4 
| CTRL-L CTRL-E } 5 | 
| CTRL-L CTRL-F } 6 
| CTRL-L CTRL-G | 7 
| CTRL-L CTRL-H } 8 
| CTRL-L CTRL-I } 9 
| CTRL-L CTRL-J } 10 
| CTRL-L CTRL-K |} 11 
| CTRL-L CTRL-L } 12 
| CTRL-L CTRL-M } 13 | 
| CTRL-L CTRL-N } 14 
| CTRL-L CTRL-O } 15 
| CTRL-L CTRL-P } 16 
| CTRL-L CTRL-Q | 17 
| CTRL-L CTRL-R } 18 
| CTRL-L CTRL-S } 19 
| CTRL-L CTRL-T } 20 
| CTRL-L CTRL-U } 21 
| CTRL-L CTRL-V | 22 
| CTRL-L CTRL-W } 23 
| CTRL-L CTRL-X | 24 


ee ee 


Each display of the requested number of lines is terminated 
with a bell sound. At this point the user may continue to 
the next page by entering a carriage return (CR). This will 
cause the same number of lines to appear; each CR will, in 
fact, produce that number of lines until the page pause line 
count is changed. To change the count, terminate write by 
entering ESC or Break, and enter a different sequence for the 
desired new line count (e.g., CTRL-L CTRL-O = 15 lines, 
etc.). 


To cancel the page pause mode, use the sequence CTRL-L 
CTRL-@. If the page pause mode is not terminated within 5 
minutes, BIOC will automatically continue output to prevent 
the terminal from being permanently tied up. 
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CTRL-M (CR) Terminate Read 
This function is a carriage return. Entering CTRL -M 
indicates to BIOC that read should be terminated. If CTRL-M 
is entered at a location other than the end of the line, BIOC 
will perform a zoom to the end of the line (EOL) before 
storing the carriage return and terminating the read request. 
CTRL-N (SO) Neutralize Selected Options Back to Default 
This code is entered to reset options back to their default 
values. CTRL-N can be entered during read operations, during 
write operations, or between read and write operations. 
Entering CTRL-N performs the following functions: 
e resets page pause to zero 
e resets backspace prompt character to CTRL~-H 
e resets ASCII read prompt character to sysgen default 


e resets backspace and CR/LF protocol to sysgen default 


e resets output mode to print-on state 


CTRL-O (SI) Toggle Output Between Print-on and Print-off 


To suppress output in the write mode, CTRL-O is’ used. To 
resume output, this code is used again. Alternately 
depressing CTRL-O will cause output to terminate and resume; 
hence, the "toggle" characteristic. When using CTRL-O to 
select the print-off mode, a prompt can be immediately 
received by a terminate read (CTRL-M). If this is not done 


within 15 seconds after output ceases, BIOC will prompt and 
reinstate the print-on mode automatically. The print-on mode 
will also be reinstated upon a successful completion of a 
read request, or upon entering CTRL-N for a neutralize 
function. 


CTRL-P (DLE) Set ASCII Read Prompt Character 


By entering CTRL-P and any ASCII character, that character 
becomes the designated prompt. When making the selection, 
the ASCII character is not displayed to the console, but is 
output by BIOC upon receipt of an ASCII read request. The 
read prompt function can be turned off by the sequence CTRL-P 
CTRL-X. To reset the ASCII read prompt character to the 
sysgen default, enter CTRL-N. 
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CTRL-Q (DC1) Removed from Input to Allow X-ON/X-OFF Flow Control 


CTRL-R (DC 2) Reprint Entered Line 


When this code is entered, the current cursor location within 
the line will determine the number of characters that will be 
reprinted on the next line. All characters, including blank 
spaces, to the left of the cursor will be reprinted. The 
CTRL-R function will be rejected if the echo state is turned 
off (see CTRL-E). 


The CTRL-R function is especially useful for hardcopy 
terminals where corrections are made over the existing typed 


lines. To view a "clean" line after all corrections have 
been made, CTRL-P is used. 


CTRL-S (DC 3) Removed from Input to Allow X-ON/X-OFF Flow Control 


CTRL-T (DC4) Single Character Transparent Mode 


The use of this code will allow the entry of function control 


characters into the input buffer. The next character entered 
after a CTRL-T will be entered directly into the _ input 
buffer. 


CTRL-W (ETB) Word Backspace (Nondestructive) 


CTRL-W causes the cursor to be backspaced (nondestructively) 
to the nearest nonalphabetic character. Thus, CTRL-W allows 
the cursor to backspace over one complete word, rather than 
one character, as with CTRL-B. Words backspaced over may be 
restored by the use of CTRL-F or CTRL-Z. CTRL-W will be 
rejected if attempted at the beginning of a line. 


CTRL-X (CAN) Cancel Current Input Line 


All characters previously entered on the current line will be 
deleted upon use of the code. Characters may not be restored 
with the CTRL-F or CTRL-Z functions. If no characters are on 
the Line, CTRL-X will be rejected. CTRL-X will turn echo 
back on if it has been turned off with CTRL-E. 


CTRL-Z (SUB) "Zoom" to Furthest End of Line 
CTRL-Z can be used to restore a line that has been backspaced 
over by CTRL-B, CTRL-W, or CTRL-]. CTRL-Z will cause the 


cursor to "zoom" to the end of the line, but will be rejected 
if there are no characters to be restored. 
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CTRL-] (GS) Backward Character Search (Nondestructive) 


This code serves to locate a specific character on the 
current line. For example, to find the character §$, enter 
CTRL-]$. BIOC will backspace until the first $ is found. To 
find any additional dollar signs on the same line, the code 
must be entered again for each time the $ symbol appears. 
Characters backspaced over may be restored by using CTRL-F or 
CTRL-Z. CTRL-] will be rejected if attempted at the 
beginning of the line. 


CTRL-A (RS) Toggle Between Insert-on and Insert-off 


Each CTRL-A toggles from inmsert-on to insert-off or from 
insert-off to insert-on. When the insert mode is selected, 
characters typed will be inserted in front of the character 
currently over the cursor. The insert mode may be selected 
only when the cursor is positioned at a location other than 
the end of the Line and the echo state is on. The insert 
mode will be terminated by another CTRL-A or by any command 
that takes the cursor position to the end of the line (e.g., 
CTRL-Z). The CTRL-C and CTRL-E functions are not valid while 
in the insert mode. All other functions are valid if the 
cursor is not in motion. All data entered while the cursor 
is in motion will be ignored until the cursor has stopped. 


CTRL-_. (US) Delete Character 


Each CTRL-_. deletes the character currently over the cursor. 
The delete code is valid only when the cursor is positioned 
at a location other than the end of the line and the echo 
state is on. Characters entered while the cursor is in 
motion will be ignored. 


WRITE MODE: 


BREAK 


ESC 


This key terminates write with the Break status. 


This key terminates write with the Break status. 


CTRL-Q 


This code resumes write after write has been suspended by 
CTRL-T or CTRL-S functions. 
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CTRL-R 
This code 
CTRL-T or 
CTRL-S 
This code 
CTRL-Q or 
CTRL-T 


This code 
CTRL-Q or 


resumes write after write 
CTRL-S functions. 


suspends write until write 
until the BREAK or ESC key 


suspends write until write 
until the BREAK or ESC key 


has 


is 
is 


is 
is 


been suspended by 


resumed by CTRL-R_ or 
depressed. 


resumed by CTRL-R- or 
depressed. 
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| commands 6-13 
Batch commands H computation operator 6-30 
INQUIRE 5-3 ' conversion operator 6-30 
LOG 5-5 H CURRENT operator 6-37 
PURGE 5-7 1 DCOMPUTE operator 6-30 
SIGNOFF 5-8 ' DHCONVERT operator 6-32 
SIGNON 5-9 H DVOLUMENAME operator 6-38 
SUBMIT 5-11 | end of task code testing . 
Batch job error handling 5-13 | commands 6-61 
Batch job priority { EXTENSION operator 6-25 
establishing 5-12 | file descriptor operators 6-24 
Batch job submission ' file existence testing . 
using the spooler 5-13 | commands 6-62 
Batch jobs 7-3 ' FITLENAME operator 6-26 
Batch processing H general description 6-1 
affect of restricted H HCOMPUTE operator 6-33 
disks on 5-13 } HDCONVERT operator 6-34 
batch task pause option 5-13 | line expansion 6-12 
commands 5-1 | logical IF commands 6-60 
error handling 5-13 } LOGICAL operators 6-29 
introduction 5=1 H message summary E-1 
Batch task pause option 5-13 | mode _ 1-6 
BFILE command 2-12 } other operators 6-35 
BIAS command 2-13 } parameter existence 
Bidirectional input/output | testing 6-62 
control H-1 { PRIOR command 6-52 
control summary for H-1 | REQUIRED operator 6-39 
BIOC. See bidirectional ' SEARCH operator 6-40 
input/output control. | SET CODE command 6-56 
BREAK command 2-14 | signon 1-7 
Break key ! STRING operator 6-43 
using the 1-10 } use of keywords 6-5 
BRECORD command 2-15 } VOLUMENAME operator 6-28 
BUILD command 2-16 } $BUILD command 6-18 
$BUILD command 6-18 | $CLEAR command 6-20 
| $CONTINUE command 6-21 
fe $COPY command 6-22 
Cc H $DEFINE command 6-23 
H $ELSE command 6-63 
CAL 4-1 | $ENDB command 6-18 
Calling a CSS file 6-2 | $EXIT command 6-45 
use of parameters 6-3 H $FREE command 6-46 
CANCEL command 2-18 | $GLOBAL command 6-47 
Character replacement command 6-14 |} $GOTO command 6-64 
H $IF...EQUAL command 6-69 
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Command substitution system 
(Cont inued) 
S$IF...GREATER command 
$IF...LESS command 
$IF...NEQUAL command 
$IF...NGREATER command 
S$IF...NLESS command 
S$IFEXTENSION command 
$IFVOLUME command 
$JOB command 
$LABEL command 
$LOCAL command 
$NOCOPY command 
$PAUSE command 
$RELEASE command 
$SET command 
$SKIP command 
$TERMJOB command 
$WAIT command 
$WRITE command 

Commands 
introduction 
COMPILE command 
COMPILE command 
language format 
COMPILE command 
multi-module format 
COMPLINK command 
language format 
multi-module format 

Computation operator 
DCOMPUTE 
DHCONVERT 
HCOMPUTE 
HDCONVERT 

CONTINUE command 

Conversion operator 
DCOMPUTE 
DHCONVERT 
HCOMPUTE 
HDCONVERT 

Creating a data file 

Creating a source program 

CRT driver. See also BIOC. 

CSS. See command 

substitution system. 


CTOP 

CTSW 

CURRENT operator 
$CILEAR command 
$CONTINUE command 


$COPY command 


D 


DCOMPUTE Operator 

Default lu assignménts 
Default variable s6ttings 
DELETE command 

DHCONVERT operatot 

DISPLAY ACCOUNTING command 
DISPLAY command 
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6-69 
6-706 
6-69 
6-69 
6-70 
6-66 
6-67 
6-48 
6-64 
6-50 
6-22 
6-51 
6-53 
6-55 
6-57 
6-48 
6-58 
6-59 


2-1 
4-14 


4-14 
4-14 


4-18 
4-18 
6-30 
6-30 
6-32 
6-33 
6-34 
2+20 
6-30 
6-30 
6-32 
6-33 
6-34 
4-4 

4-1 


2-38 
2-37 
6-37 
6-20 
6-21 
6-58 
6-22 


6-30 
4-10 
4-10 
2*21 
6-32 
2-24 
2-22 
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DISPLAY DEVICES command 
sample display 
DISPLAY DFLOAT command 
DISPLAY FILES command 
DISPLAY FLOAT command 
DISPLAY LU command 
DISPLAY PARAMETERS command 
fields 
task option bit 
definitions 
DISPLAY REGISTERS command 
DISPLAY TIME command 
DISPLAY USERS command 
DVOLUMENAME operator 
$DEFINE command 


ACCOUNT operator 
CLEAR operator 
computation operator 
conversion operator 
CURRENT operator 
DCOMPUTE operator 
DHCONVERT operator 
DVOLUMENAME operator 
EXTENSION operator 
file descriptor operators 
FILENAME operator 
HCOMPUTE opérator 
HDCONVERT operator 
LOGICAL operators 
other operators 
REQUIRED operator 
SEARCH operator 
STRING operator 
VOLUMENAME operator 


E 


ECM. See environmental 
control monitor. 
EDF. See environment 
descriptor file. 
EDIT command 
ENABLE command 
End of task code testing 
End of task code testing 
coimmands 
$IFE n 
$IFG n 
$IFL n 
$IFNE n 
$IFNG n 
$IFNL n 
ENDB command 
ENV command 


Environment descriptor file 
ENVIRONMENT= parameter 
Environmental control monitor 
EXAMINE command 

EXEC 


EXEC command 
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2725 
2-25 
2-27 
2-28 
2-34 
2-35 


2-37 


2-38 
2-42 
2-43 
2-44 
6-38 
6-10 
6-11 
6-23 
6-24 
6-36 
6-30 
6-30 
6-37 
6-30 
6-32 
6-38 
6-25 
6-24 
6-26 
6-33 
6-34 
6-29 
6-35 
6-39 
6-40 
6-43 
6-28 


Executing a program 
Executing multiple programs 
as a single program 
EXTENSION operator 

$ELSE 

$ELSE command 

$ENDB command 

$ENDC 

$EXIT command 


F 


fds. See file descriptors. 
FFILE command 
File conventions 
File descriptor operators 
EXTENS ION 
F [LENAME 
VOLUMENAME 
File descriptors 
format 
parameters 
File existence testing 
File existence testing 
commands 
$I FNX 
$IFX 
File initialization. See 
INIT command. 
Filename operator 
Foreground task 
interfacing with 
programming details 
restricted task-ids 
Foreground task mode 
FORT 
FORTO 
FORTZ 
FRECORD command 
$FOREGROUND task interface 
messages 
$FREE command 


G 


Global variables 
Group account numbers 
$GLOBAL command 


$GOTO command 


H 


Hasp interface 

linking the HASP task 
Hasp interface messages 
Hasp interface mode 
HCOMPUTE operator 
HDCONVERT operator 
HELP command 
Help facility 
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6-9 

LeLi 
6-10 
6-47 
6-64 


INIT command 
Input spooling 
/@INPUT control statement 
/@®SUBMIT control 
statement 
control card statements 
INQUIRE command 
Interactive task to terminal 
mode 
ITC/RELIANCE interface 
$IF...EQUAL command 
$IF...GREATER command 
$IF...LESS command 
$IF...NEQUAL command 
$IF...NGREATER command 
$IF...NILESS command 
$IFE n 
$IFEXTENSION command 
$IFG n 
$IFL n 
$IFNE n 
$IFNG n 
$IFNL n 
$ [TFNNUI.L 
$IFNULL 
$ [FNX 
$IFVOLUME command 
S$IFX 


J 
$JOB command 
K 
Keywords 
defining 


examples of illegal 
referencing within the 
CSS 

rules for use of 

valid examples of 


L 


Language tab character 
LINK command 
link sequences 

LIST command 
LOAD command 
Loading a task 
Loading tasks. 

command. 
Local variables 
LOG command 


See TASK 


checkpointing 

Logical IF commands 
comparing two arguments 
end of task code testing 
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Logical IF commands 
(Cont inued) 
file existence testing 
parameter existence 
testing 
$ELSE 
$ENDC 
$IF...EQUAL 
$IF...GREATER 
$IF...LESS 
$IF...NEQUAL 
$IF...NGREATER 
$IF...NILESS command 
LOGICAL operators 
$.ABEL command 
$LOCAL command 


M 


MACRO 

MESSAGE command 

MODIFY command 

Modifying a program 

MPRI 

MTM. See multi-terminal 

monitor. 

MTM/non-MTM task interface 

messages 

Muliti-terminal monitor 
ALLOCATE command 
ASSIGN command 
authorization 
BFILE command 
BIAS command 
BREAK command 
BRECORD command 
BUILD command 
CANCEL command 
CLOSE command 
command summary 
CONTINUE command 
DELETE command 
devices 
DISPLAY ACCOUNTING 
command 
DISPLAY command 
DISPLAY DEVICES command 
DISPLAY DFLOAT command 
DISPLAY FILES command 
DISPLAY FLOAT command 
DISPLAY LU command 
DISPLAY PARAMETERS 
command 


DISPLAY REGISTERS command 


DISPLAY TIME command 
DISPLAY USERS command 
dynamic functions 
ENABLE command 

ENDB command 
environments 

EXAMINE command 

FFILE command 

FRECORD command 

HELP command 
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Multi-terminal monitor 
(Cont inued ) 
INIT command 
introduction 
LOAD command 
LOG command 
MESSAGE command 
message summary 
MODIFY command 
operation 
OPTIONS command 
PASSWORD ' command 
PAUSE command 
PREVENT command 
PRINT command 
priority 
privileged users 
PUNCH command 
RENAME command 
REPROTECT command 
REWIND command 
RVOLUME command 
RW command 
SEND command 
SET GROUP command 
SET KEYOPERATOR command 
SET LOG command 
SET PRIVATE command 
SIGNOFF command 
SIGNON command 
SPOOLFILE command 
START command 
tailoring functions 
TASK command 
TEMPFILE command 
transmitting messages 
user commands 
user information 
VOLUME command 
WFILE command 
XALLOCATE command 
XDELETE command 
$RELEASE command 

Multi-terminal monitor 

environments 
batch 
interactive 

MUSP 

MXSP 


N 


Naming global variables 
Naming local variables 
Naming new global variables 
Naming new internal variables 
New global variables 


referencing the value of 
New internal variables 


referencing the value of 
NLU 
SNOCOPY command 
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OPTIONS command 
OS/32 spooler 
Other operators 
CLEAR 
CURRENT 
DVOLUMENAME 
REQUIRED 
SEARCH 
STRING 
Output spooling 
assigning logical units 


P,Q 


Parameter existence testing 
Parameter existence testing 
commands 
$ IFNNULL 
$ TFNULL 
PASCAL 
PASSWORD command 
PAUSE command 
PREVENT command 
PRINT command 
PRIOR command 
Private account numbers 
Privileged users 
Program development 
assigning logical units 
command availability 
command summary 
commands 
creating a data file 
creating a source program 
default lu assignments 
default variable settings 
error recovery 
executing a program 
executing multiple 
programs 
language commands 
language tab character 
message summary 
modifying a program 
re-executing a modified 
prgoram 
sample sessions 
source file language 
extensions 
Program development commands 
ADD 
COMP ILE 
COMPLINK 
EDIT 


Prompt conventions 
PUNCH command 
PURGE command 
$PAUSE command 
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Re-executing a modified 
program 

REMOVE command 

RENAME command 

REPROTECT command 

REQUIRED operator 

Reserved variables 

Restricted task-ids 

REWIND command 

RPG 

RUN command 

RVOLUME command 

RW command 

$RELEASE command 


s 


Sample program development 
sessions 

SCTASK 

SEARCH operator 

Security 

SEND command 

SET CODE command 

SET GROUP command 

SET KEYOPERATOR command 


SET LOG command 
SET PRIVATE command 
SIGNOFF command 


SIGNON command 


SLOC 

Source file language 
extensions 

SPL/32 and MT™ interaction 

SPL/32 spooler 


MTM interaction 
SPOOLFILE command 
SPL/32 spooler 
Spooling 
/®INPUT control statement 
/@SUBMIT control 
statement 
control card statements 
errors 
input 
0OS/32 spooler 
output 
SPL/32 and MTM 
interaction 
SPL/32 spooler 


START command 
STAT 
STRING operator 
SUBMIT commana 
batch job priority 
SVOL 
System account numbers 
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$SET command 6-55 


USERINIT.CSS 2-84 
$SKIP command 6-57 USSP 2-37 
UTOP 2-38 
, Vv 
TASK command 2-90 . 
Task executing mode 1-6 Maer _ 
Task interfaces 1Geal . 


foreground tasks 


ee ere - 
oe : naming new global “10 
non-MTM _ naming new internal -10 


new global 
new internal 


i 


Task loaded mode 


TEMPF I.E command 1 weaervcd -13 

Terminal conventions -10 tvnes of 

Terminal modes - YP es 5 
use of - 


command mode 

CSS mode 

foreground task mode 
hasp interface mode 
interactive task to 


VOLUME command 
VOLUMENAME operator 
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terminal 1-6 

task executing mode 1-6 W 

task loaded mode 1-6 
WerminaL users Wait status bit definitions 2-40 

number of 1-4 WFILE command 2-96 
TOPT 2-37 $WAIT command 6-58 
Transmitting messages 1-4 $WRITE command 6-59 
$TERMJOB command 6-48 

X,Y,Z 
U 
XALLOCATE command 2-97 

UBOT 2-38 XDELETE command 2-100 
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DOCUMENTATION CHANGE NOTICE 


The purpose of this documentat ion change notice (DCN) is to 
provide a quick and efficient way of making technical changes’ to 
manuals before they are formally updated or revised. 


The manual affected by these changes is: 
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e Page 2-87 
In the Parameters column, add IMAGE directly under VFC. Then 
change the last sentence of - VFC paragraph to: 


If IMAGE is specified, there ‘is no VFC for the device assigned 
to the specified lu. 

@® Page 2-87 
In the Parameters column, add NOIMAGE directly above NOVFC. 
Then change the paragraph to: 


turns the VFC option or IMAGE option off for the assigned lu. 
NOVFC is the default option. — 
@ Page 2-87 
Add the following parameters and descriptions before COPIES=: 
CHECKPOINT turns on checkpointing for the assigned lu. 
This is the default option. The global 


checkpoint option must be on. 


NOCHECKPO INT turns off checkpointing for the assigned lu. 
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